XuLaLa.Tech

在使用 Node.js 的包管理工具 NPM（Node Package Manager）时，我们经常需要做一些全局或者项目级别的配置。这些配置可以通过 .npmrc 文件来完成。本文将深入探讨 .npmrc 文件的作用，位置，配置方式，以及常见的配置项。

文章目录

• 1 基本概念
• 2 .npmrc 文件的位置与优先级
• 3 .npmrc 文件的配置
• 4 常见的 .npmrc 配置与常用镜像源
• 5 注意事项与总结

基本概念

.npmrc 文件是 NPM 读取配置的文件。它是一个简单的文本文件，可以放置在用户的主目录，全局的 NPM 目录，或者项目的根目录下。在这个文件中，我们可以配置诸如代理服务器，镜像源，缓存目录等 NPM 的设置。

.npmrc 文件的位置与优先级

.npmrc 文件可以存在于多个位置，并且 NPM 在读取配置时，会按照一定的优先级从这些位置读取。优先级从高到低分别是：

1. 项目级别的 .npmrc 文件（位于项目的根目录下）
2. 用户级别的 .npmrc 文件（位于用户的主目录下）
3. 全局级别的 .npmrc 文件（位于全局的 NPM 目录下）
4. NPM 内置的配置

项目根目录的 .npmrc 的配置，优先级最高，且随着项目一起，可以免去因不同开发者的电脑的环境配置不同而导致的依赖下载异常的问题；实际开发中也推荐在根目录下配置一份，可以给每个项目配置不同的镜像，项目之间的配置互不影响。

.npmrc 文件的配置

.npmrc 文件的配置非常简单，每一行都是一个配置项，格式为 key=value。例如，我们可以配置 NPM 的镜像源为淘宝的镜像：

registry=https://registry.npm.taobao.org/

此外，我们还可以为特定的项目配置局部镜像源，例如 electron 和 sass：

# 配置此项目的局部镜像源之 electron
electron_mirror = "https://npm.taobao.org/mirrors/electron/"
# 配置此项目的局部镜像源之 sass
# node-sass 现在很少有项目用了，主要用来兼容一些老旧项目
sass_binary_site= "https://npm.taobao.org/mirrors/node-sass/"

如果 node 版本与 package.json 配置不同的时候，我们还可以通过配置 engine-strict 为 true 来中断命令执行：

engine-strict = true

常见的 .npmrc 配置与常用镜像源

下面是一些常见的 .npmrc 配置项：

1. registry：配置 NPM 的镜像源
2. proxy 和 https-proxy：配置 NPM 的代理服务器
3. prefix：配置全局安装的模块的位置
4. cache：配置 NPM 的缓存目录
5. save-exact：配置 NPM 安装模块时是否保存精确的版本号

常用的 NPM 镜像源有：

• 淘宝镜像源：https://registry.npmmirror.com，https://registry.npm.taobao.org
• 腾讯云镜像源：http://mirrors.cloud.tencent.com/npm/
• 华为云镜像源：https://mirrors.huaweicloud.com/repository/npm/
• 官方默认全局镜像：https://registry.npmjs.org

注意事项与总结

• yarn 会读取 .npmrc 的配置文件，所以不必为 yarn 再设置一次。
• 删除 .npmrc 文件，即可恢复默认配置。
• 可以在项目根目录命令行输入 npm config get registry 查看是否设置成功。

.npmrc 文件是我们在使用 NPM 时的重要工具，通过它我们可以灵活地配置 NPM 的许多设置。虽然它的使用非常简单，但是正确地使用它可以极大地提高我们的工作效率。希望本文能帮助你更好地理解和使用 .npmrc 文件。