如何配置npm安装自定义库时从官方源拉取第三方依赖？

问题原因 #

执行安装命令时指定了私有仓库作为唯一registry，npm会尝试从该私有源拉取所有依赖（包括仅存在于官方npm源的parse-domain），私有仓库没有这个包，因此抛出404错误。

解决方法 #

方法1：项目级.npmrc配置（推荐） #

在需要安装私有库的项目根目录创建/修改.npmrc文件，配置源映射：

# 指定私有库从私有源拉取
my-library:registry=https://my-custom-repo.com/storage/npm/artifacts/
# 其余所有公共依赖使用官方npm源
registry=https://registry.npmjs.org/

如果你的私有库带有命名空间（如@my-org/my-library），则调整配置为：

@my-org:registry=https://my-custom-repo.com/storage/npm/artifacts/
registry=https://registry.npmjs.org/

配置完成后，直接执行安装命令即可：

npm install my-library@latest --legacy-peer-deps

方法2：临时安装命令 #

如果仅需临时安装，可在命令中同时指定双源：

npm install my-library@latest --registry=https://registry.npmjs.org/ --my-library:registry=https://my-custom-repo.com/storage/npm/artifacts/ --legacy-peer-deps

若私有库带命名空间，替换为对应的scope配置：

npm install @my-org/my-library@latest --registry=https://registry.npmjs.org/ --@my-org:registry=https://my-custom-repo.com/storage/npm/artifacts/ --legacy-peer-deps

方法3：全局npm配置（不推荐） #

若希望所有项目默认使用官方源，仅私有库走私有源，可修改全局npm配置：

npm config set registry https://registry.npmjs.org/
npm config set my-library:registry=https://my-custom-repo.com/storage/npm/artifacts/

配置后，后续安装无需额外指定参数。

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