如何通过单条npm install命令同时安装私有与公共NPM包

这个场景太常见了——全局registry设成官方的话私有包拉不到，设成私有registry公共包又出问题，其实有几种优雅的方式能让你用单条npm install同时搞定两类包：

方案1：给私有包单独指定registry（适合零散私有包） #

直接在package.json的依赖项里，给每个私有包加上完整的registry前缀，格式为"包名": "私有registry地址/包名@版本号"。举个实际例子：

{
  "dependencies": {
    // 公共包，用全局默认的registry（比如npm官方）
    "react": "^18.2.0",
    "lodash": "^4.17.21",
    // 私有包，明确指定私有registry地址
    "@my-team/payment-sdk": "https://my-private-registry.com/@my-team/payment-sdk@1.2.0"
  }
}

配置好后执行npm install，npm会自动针对私有包去你指定的registry拉取，公共包则使用全局默认的registry，一次命令就能完成所有依赖安装。

方案2：用Scope + 项目级.npmrc（适合同属一个组织的私有包） #

如果你的私有包都属于同一个npm scope（比如@your-company），这种方法更简洁，不用逐个包配置registry：

1. 在项目根目录创建一个.npmrc文件，添加以下配置：

# 给指定scope的包绑定私有registry
@your-company:registry=https://your-private-registry.com/
# 公共包使用官方registry（如果全局默认已经是官方的，这行可以省略）
registry=https://registry.npmjs.org/

2. 然后package.json里的依赖就可以正常书写，不用加额外前缀：

{
  "dependencies": {
    "react": "^18.2.0",
    "@your-company/admin-ui": "^3.1.0",
    "@your-company/core-api": "^2.0.5"
  }
}

执行npm install时，npm会自动识别@your-company开头的包，去对应的私有registry拉取，其他包则走默认registry，完全满足单命令安装的需求。

额外小贴士：私有包需要认证怎么办？ #

如果你的私有registry需要账号密码或token认证，有两种安全的处理方式：

• 方式一：执行npm login --registry=https://your-private-registry.com/，按照提示输入账号密码，npm会把认证信息存在全局.npmrc里，项目里的.npmrc只需要保留scope和registry的映射即可。
• 方式二：在项目的.npmrc里添加认证token（注意把这个文件加入.gitignore，不要提交到代码仓库）：

@your-company:registry=https://your-private-registry.com/
//your-private-registry.com/:_authToken=your-personal-auth-token
registry=https://registry.npmjs.org/

内容的提问来源于stack exchange，提问作者Zahidur Rahman