npm install
常用的命令行参数选项:
1. 依赖安装相关:
# 仅安装生产环境依赖
npm install --production
npm install --only=prod
# 仅安装开发环境依赖
npm install --only=dev
# 精确安装指定版本,不使用 ^或~
npm install --save-exact
# 全局安装
npm install -g 或 --global
2. 版本和依赖处理:
# 忽略 package-lock.json,重新生成
npm install --no-package-lock
# 强制重新下载所有包
npm install --force
npm install -f
# 忽略脚本
npm install --ignore-scripts
# 处理依赖冲突
npm install --legacy-peer-deps # 忽略所有 peerDependency 的冲突
npm install --strict-peer-deps # 严格遵循 peerDependency 的版本要求
3. 缓存相关:
# 离线模式,使用缓存
npm install --offline
# 强制使用在线模式
npm install --no-offline
# 清除缓存后安装
npm install --no-cache
4. 日志和输出:
# 显示详细日志
npm install --verbose
npm install -d
# 显示更多的进度条
npm install --progress
# 静默模式,最少的输出
npm install --silent
npm install -s
# 输出调试信息
npm install --debug
5. 安全相关:
# 审计依赖包的安全漏洞
npm install --audit
# 跳过安全审计
npm install --no-audit
# 运行安全审计并自动修复
npm install --audit fix
6. 其他实用选项:
# 不更新 package.json
npm install --no-save
# 干运行,不实际安装
npm install --dry-run
# 跳过可选依赖
npm install --no-optional
# 指定特定的 registry
npm install --registry=https://registry.npm.taobao.org
一些常见的组合用法:
# 常用于生产环境的干净安装
npm install --production --pure-lockfile
# 开发环境完整重装
npm install --force --verbose
# CI环境常用
npm install --no-audit --no-progress --no-optional
使用这些参数时的建议:
-
在开发环境中,通常使用默认的
npm install
即可 -
在生产环境或 CI/CD 中,建议使用:
--production
减少不必要的依赖--no-audit
加快安装速度--pure-lockfile
确保依赖版本一致性
-
遇到依赖冲突时的推荐处理顺序:
- 先尝试更新相关包到兼容版本
- 使用
--legacy-peer-deps
- 最后才考虑使用
--force
记住,某些参数组合可能会带来风险,使用前最好先了解其影响。比如 --force
可能会导致依赖版本不一致,--no-audit
则会跳过安全检查。