npm 常用命令速查：安装、版本管理、脚本和高效技巧

日常开发用到的 npm 命令其实不多，核心就 10 个左右。记住这些够用 90% 的场景，剩下的需要时再查。

安装和卸载

bash
npm install              # 根据 package.json 安装所有依赖
npm install react        # 安装到 dependencies
npm install -D jest      # 安装到 devDependencies
npm install -g typescript # 全局安装
npm uninstall react      # 从 dependencies 移除

npm i 是 install 的缩写，npm un 是 uninstall 的缩写。

版本管理

bash
npm outdated             # 查看过时的包
npm update               # 更新到 semver 允许的最新版本
npm install react@18.2.0 # 安装特定版本
npm install react@^18    # 18.x.x 最新

版本号语义：^18.2.0 允许 18.x.x（主版本不变），~18.2.0 允许 18.2.x（次版本不变）。

运行脚本

bash
npm run dev        # 运行 scripts.dev
npm run build      # 运行 scripts.build
npm start          # 等价于 npm run start
npm test           # 等价于 npm run test

start 和 test 可以省略 run，其他脚本必须加。查看所有可用脚本：npm run。

发布

bash
npm login              # 登录
npm publish            # 发布当前包
npm version patch      # +0.0.1 并自动 git commit + tag
npm version minor      # +0.1.0
npm version major      # +1.0.0

查看包信息

bash
npm view react version       # 最新版本号
npm view react versions      # 所有已发布版本
npm ls                       # 当前项目依赖树
npm ls react                 # 某个包的安装版本

高效技巧

npx 执行一次性命令：不用全局安装，npx create-react-app my-app 用完即弃。npx 先找项目本地，找不到再下载临时执行。

npm ci 代替 npm install：CI/CD 环境必须用 npm ci。根据 package-lock.json 精确安装，比 install 快且版本完全一致。

清理缓存：安装报错"Unexpected end of JSON input"时，npm cache clean --force 清理重试。