npm install 介绍

260 阅读2分钟

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

使用这些参数时的建议:

  1. 在开发环境中,通常使用默认的 npm install 即可

  2. 在生产环境或 CI/CD 中,建议使用:

    • --production 减少不必要的依赖
    • --no-audit 加快安装速度
    • --pure-lockfile 确保依赖版本一致性
  3. 遇到依赖冲突时的推荐处理顺序:

    • 先尝试更新相关包到兼容版本
    • 使用 --legacy-peer-deps
    • 最后才考虑使用 --force

记住,某些参数组合可能会带来风险,使用前最好先了解其影响。比如 --force 可能会导致依赖版本不一致,--no-audit 则会跳过安全检查。