.nrmrc和.yarnrc配置镜像源

用途

使用npm或者yarn安装依赖时，指定依赖的镜像源。

示例

使用npm安装依赖

# .npmrc

# 设置同一个前缀/目录下包的源
# 下面的设置将前缀为@babel的包源指向了华为源
# 如果@babel前缀的包内部依赖了其他非@babel前缀的包，那么这些非@babel的包将不适用该规则
@babel:registry=https://mirrors.huaweicloud.com/repository/npm/

# 指定项目下所有包的源
# 如果上面的前缀规则没有匹配到，则使用这里的源
registry=http://mirrors.cloud.tencent.com/npm/

使用小于yarn@2.0安装依赖

# .yarnrc

# 设置同一个前缀/目录下包的源 验证有效
# 下面的设置将前缀为@babel的包源指向了腾讯源
# 如果@babel前缀的包依赖了其他非@babel前缀的包，那么这些非@babel的包将不适用该规则
"@babel:registry" "https://mirrors.huaweicloud.com/repository/npm/"

# 如果上面的前缀规则没有匹配到，则使用这里的源
"registry" "http://mirrors.cloud.tencent.com/npm/"

使用大于等于yarn@2.0安装依赖

# .yarnrc.yml

# 设置同一个前缀/目录下包的源 验证有效
# 下面的设置将前缀为babel的包源指向了华为源
# 如果babel前缀的包依赖了其他非babel前缀的包，那么这些非babel的包将不适用该规则
"npmScopes":
  # babel不能以@为开头
  "babel":
    "npmRegistryServer": "https://mirrors.huaweicloud.com/repository/npm/"

# 如果上面的前缀规则没有匹配到，则使用这里的源
"npmRegistryServer": "http://mirrors.cloud.tencent.com/npm/"

注意事项

如何单独为某个包指定镜像源？

npm和yarn均无法为单个包配置镜像源。

# .npmrc

# 目的是为antd单独指定镜像源，可惜这是不被支持的
antd:registry=https://mirrors.huaweicloud.com/repository/npm/

配置文件的优先级如何？

配置文件有优先级之分。
项目根目录中的要比用户目录中的配置文件优先级更高。

当执行npm install命令，npm会按照如下顺序查找配置。读取成功就不再往后找了。

1. /project/.npmrc
2. /user/.npmrc

用户目录里面的配置是哪里来的？

是你通过命令行设置的。

执行下面的命令，将会在用户目录下创建一个.npmrc文件。

npm config set registry https://registry.npmmirror.com

yarn可以使用.npmrc的配置吗？

可以，所以如果你有了.npmrc，yarn可以直接用。（仅限于小于yarn@2.0的版本中）

当执行yarn install命令，yarn会按照如下顺序查找配置。读取成功就不再往后找了。

1. /project/.npmrc
2. /user/.npmrc
3. /project/.yarnrc
4. /user/.yarnrc

yarn大于等于2.0

配置文件需要加文件后缀。

文件名必须为.yarnrc.yml，语法也修改了，且不再支持.npmrc。

yarn大于等于2.0时

lock文件无法查看包的下载来源怎么办？

虽然我们无法直接通过lock文件查看，但是我们可以间接确认。
那就是把npmRegistryServer或者npmScopes中的npmRegistryServer修改为一个无法正常使用的地址，这样yarn在尝试下载的时候就会给出错误信息，间接的给出了下载源的地址。

二进制文件下载

# 指定sass的二进制文件下载，不适用于npm包
sass_binary_site=https://npm.taobao.org/mirrors/node-sass/

# 指定electron的二进制文件下载，不适用于npm包
electron_mirror=https://npm.taobao.org/mirrors/electron/

# npm包镜像源
registry=https://registry.npm.taobao.org

其他

.npmrc配置文档：
https://docs.npmjs.com/cli/v8/configuring-npm/npmrc

.yarnrc配置文档（yarn小于2.0）：
https://classic.yarnpkg.com/en/docs/yarnrc

.yarnrc.yrm配置文档（yarn大于等于2.0）：
https://yarnpkg.com/configuration/manifest

查看当前设置的源
npm config get registry

查看当前npm配置文件信息
npm config get