什么是 npm 配置？
npm 配置是指对 npm 命令行工具 (CLI) 和其行为进行的一系列自定义设置。这些设置决定了 npm 如何执行各种任务，例如安装依赖、发布包、连接注册表、处理网络请求、管理缓存等。通过配置，开发者和系统管理员可以根据特定的项目需求、网络环境或个人偏好来调整 npm 的默认行为。
你可以配置的内容非常广泛，包括但不限于：
- 使用哪个软件包注册表（比如官方 npmjs.org 或私有库）。
- 如何通过 HTTP/HTTPS 代理连接网络。
- 软件包安装到哪里（全局或本地项目）。
- 缓存的位置和管理方式。
- 认证凭证，用于访问私有包或发布包。
- 脚本执行时的行为。
- 并行安装的数量限制。
- 日志输出的详细程度。
- 初始化新项目时的默认值。
为什么需要配置 npm？
配置 npm 的重要性在于它提供了极大的灵活性和控制力，使其能够适应各种复杂多变的开发环境和工作流程。以下是一些常见的需要配置 npm 的场景：
- 使用私有或内部注册表：许多公司拥有自己的 npm 注册表，用于托管内部开发的软件包。你需要配置 npm 指向这些内部注册表，以便安装和发布公司的私有包。
- 穿越企业代理服务器：在受限的网络环境中，尤其是公司内部，访问外部网络通常需要通过代理服务器。配置 npm 的代理设置是其能够正常下载和安装软件包的前提。
- 优化安装性能：通过调整缓存设置、并行下载/安装数量等，可以显著提升软件包安装的速度，尤其是在网络条件不理想或依赖项众多的项目中。
- 管理认证信息：访问私有 npm 包或向注册表发布包通常需要认证。配置认证信息（如 token）可以让你无需每次手动输入凭证。
- 定制项目初始化：设置 `npm init` 的默认配置，可以快速创建符合团队规范的新项目，避免重复输入作者信息、许可证等。
- 在 CI/CD 环境中使用：自动化构建和部署流程（CI/CD）通常需要配置 npm，例如设置无交互模式、指定注册表、处理认证等，以确保自动化任务顺利执行。
- 解决安装问题：在某些极端情况下，可能需要调整 SSL 验证、网络超时等设置来解决特定的安装失败问题（尽管更改某些安全设置需要谨慎）。
总而言之，配置 npm 是为了让它更好地服务于你的具体开发需求和所处的技术环境。
npm 配置保存在哪里？
npm 配置不是集中存储在一个地方，而是分散在几个不同的位置，并且它们之间存在一个优先级顺序。了解这些位置对于理解和管理 npm 配置至关重要。配置的层级从低到高（优先级递增）通常是：
- 内置配置 (Built-in): npm 内部的默认配置。这是所有配置的基础。
-
全局配置 (Global): 存储在全局 `.npmrc` 文件中。这个文件影响当前用户在**任何项目**中运行 npm 命令时的行为。它的位置通常位于 npm 的安装目录下的 `etc/npmrc`。你可以通过运行
npm config get prefix
找到 npm 的安装前缀，然后在该前缀下查找 `etc/npmrc`。
- 用户配置 (User): 存储在用户主目录下的 `.npmrc` 文件中 (`~/.npmrc` 或 `$HOME/.npmrc`)。这是最常用的存储用户级配置的位置，它会覆盖全局配置中的同名设置。
- 项目配置 (Project): 存储在当前项目根目录下的 `.npmrc` 文件中。这个文件**只影响当前项目**，它的配置会覆盖用户配置和全局配置中的同名设置。这是配置特定项目行为（如项目专属的私有注册表）的最佳位置。
- 环境变量 (Environment Variables): 以 `NPM_CONFIG_` 开头的环境变量。例如，设置环境变量 `NPM_CONFIG_REGISTRY=http://my-registry.com` 会覆盖所有 `.npmrc` 文件中的 `registry` 设置。环境变量通常用于 CI/CD 流程或临时覆盖配置。键名需要转换为大写，并将 `-` 替换为 `_`。
- 命令行参数 (Command-line Flags): 直接在 npm 命令中使用的参数，例如 `npm install –registry=http://my-registry.com`。命令行参数具有最高的优先级，会覆盖所有其他层级的配置。
当 npm 需要一个配置值时，它会按照上述顺序查找，一旦找到某个层级有该配置，就会使用该值，不再继续查找优先级更低的层级。
有多少种 npm 配置选项？
npm 提供了数量庞大的可配置选项，涵盖了 npm 操作的方方面面。确切的数量随着 npm 版本的更新可能会有 slight changes，但通常有超过一百个甚至更多的选项。你不需要记住所有选项，只需要了解哪些选项与你常见的需求相关即可。
要查看当前环境所有有效的配置选项及其来源，可以使用命令：
npm config list -l
这个命令会列出包括默认值在内的所有配置项，并指示每个配置项是从哪个层级加载的（如 `user`、`global`、`cli` 等）。
如果你只想看当前用户设置的配置（排除默认值），可以使用：
npm config list
这些命令是理解和调试 npm 配置的有力工具。
如何配置 npm？
配置 npm 主要有三种方式：使用 `npm config` 命令、直接编辑 `.npmrc` 文件，或者设置环境变量。
使用 npm config 命令
`npm config` 命令提供了一个便捷的接口来管理配置。
-
设置配置：
npm config set <key> <value> [<level>]
默认情况下，这个命令会将配置写入用户级的 `.npmrc` 文件 (`~/.npmrc`)。
例如，设置淘宝镜像作为默认注册表：npm config set registry https://registry.npmmirror.com/
如果要设置全局配置（影响所有用户，需要管理员权限），可以加上 `–global` 或 `–location=global`：
npm config set registry https://registry.npmmirror.com/ –global
设置项目级配置（写入当前目录的 `.npmrc`，如果不存在则创建）：
npm config set registry https://my-private-registry.com/ –location=project
请注意，直接使用 `npm config set –location=project` 可能不是最常见的项目级配置方式，通常项目级配置是直接编辑项目根目录下的 `.npmrc` 文件。
-
获取配置：
npm config get <key>
获取某个配置项当前生效的值。
例如，获取当前使用的注册表地址：npm config get registry
-
删除配置：
npm config delete <key> [<level>]
删除某个配置项。默认删除用户级的配置。
例如，删除用户级的注册表设置：npm config delete registry
删除全局注册表设置：
npm config delete registry –global
-
列出配置：
npm config list
列出当前所有生效的非默认配置。
npm config list -l
列出所有生效的配置（包括默认值）及其来源。
直接编辑 .npmrc 文件
`.npmrc` 文件是简单的文本文件，每行是一个配置项，格式为 `key=value`。你可以直接使用文本编辑器打开并修改这些文件（用户级的 `~/.npmrc` 或项目级的 `.npmrc`）。
例如，编辑 `~/.npmrc` 文件，添加以下内容来设置注册表和代理：
registry=https://registry.npmmirror.com/
proxy=http://your-proxy-server:8080/
https-proxy=http://your-proxy-server:8080/
strict-ssl=false
这种方式适用于一次性设置多个配置项，或者需要添加一些 `npm config set` 命令不太方便处理的复杂配置（如带作用域的注册表或认证信息）。
设置环境变量
通过设置环境变量来配置 npm，格式是 `NPM_CONFIG_
例如，在终端中临时设置注册表：
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/
在 Windows 的命令提示符中：
set NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/
这种方式常用于自动化脚本、CI/CD 环境或临时测试某个配置。它也常用于传递敏感信息，如认证 Token，避免将其直接写入 `.npmrc` 文件并被提交到版本控制。
怎么进行常见的 npm 配置？ (具体示例)
配置注册表 (Registry)
这是最常见的配置之一，用于指定 npm 从哪里下载软件包。
-
设置默认注册表：
将所有包的下载源指向指定的 URL：
npm config set registry https://registry.npmmirror.com/
或在 `.npmrc` 中添加：
registry=https://registry.npmmirror.com/
-
设置带作用域的注册表 (Scoped Registry)：
如果你使用带有作用域的包（如 `@my-scope/my-package`），可以为特定作用域指定不同的注册表。这常用于同时使用官方 npm 库和内部私有库的情况。
将 `@my-scope` 下的包指向内部注册表：
npm config set @my-scope:registry https://my-private-registry.com/
或在 `.npmrc` 中添加：
@my-scope:registry=https://my-private-registry.com/
这样，安装 `@my-scope/some-package` 时会访问 `https://my-private-registry.com/`，而安装其他包（如 `react`）时仍会访问默认注册表。
配置代理服务器 (Proxy)
如果你在需要通过代理才能访问外部网络的开发环境中，需要配置代理。
-
设置 HTTP 和 HTTPS 代理：
npm config set proxy http://username:password@your-proxy-server:port/
npm config set https-proxy http://username:password@your-proxy-server:port/或在 `.npmrc` 中添加：
proxy=http://username:password@your-proxy-server:port/
https-proxy=http://username:password@your-proxy-server:port/如果代理不需要认证，可以省略 `username:password@` 部分。
-
设置不走代理的地址 (no-proxy)：
如果你设置了代理，但希望访问某些地址时不经过代理（例如内部网络的地址），可以使用 `no-proxy`。
npm config set no-proxy “localhost,127.0.0.1,.myinternaldomain.com”
或在 `.npmrc` 中添加：
no-proxy=localhost,127.0.0.1,.myinternaldomain.com
多个地址之间用逗号分隔。
配置缓存 (Cache)
npm 会缓存下载的软件包，以便离线安装或加速重复安装。
-
查看缓存位置：
npm config get cache
-
设置缓存位置：
npm config set cache /path/to/your/npm/cache
-
清理缓存：
npm cache clean –force
清理缓存通常用于解决一些依赖问题或释放磁盘空间。
-
离线模式：
强制 npm 只使用缓存中的包，不访问网络。仅在你确定所需包已在缓存中时使用。
npm install –offline
或配置：
npm config set offline true
配置认证信息 (Authentication)
访问私有 npm 包或向注册表发布包需要认证。
-
使用 `npm login`：
对于大多数注册表，运行 `npm login` 命令会引导你输入用户名、密码和邮箱。成功后，npm 会自动在用户级的 `.npmrc` 文件中生成一个认证 token。
npm login
-
手动在 .npmrc 中添加 Token：
对于特定的注册表或自动化场景，你可能需要手动添加认证 token。格式通常是：
//<registry-url>/:_authToken=”your-auth-token”
例如，对于 npmjs.org 的 token：
//registry.npmjs.org/:_authToken=”npm_YOUR_TOKEN_HERE”
对于带作用域的私有注册表：
//@my-scope:registry=https://my-private-registry.com/
//my-private-registry.com/:_authToken=”private-token”重要提示： 包含认证 token 的 `.npmrc` 文件非常敏感，**切勿**将其提交到公共或不安全的版本控制仓库。在 CI/CD 环境中，优先使用环境变量传递 Token (`NPM_CONFIG__AUTH=
`)。
配置 SSL 验证 (Strict SSL)
默认情况下，npm 会严格验证 HTTPS 证书。在某些企业内部网络使用自签名证书时，这可能导致问题。
注意：禁用 SSL 验证会降低安全性，仅在明确了解风险且别无选择时使用，并且通常应该只作为临时解决方案。
npm config set strict-ssl false
或在 `.npmrc` 中添加：
strict-ssl=false
配置日志级别 (Log Level)
控制 npm 命令输出的详细程度。对于调试很有用。
-
设置日志级别：
npm config set loglevel info
或在 `.npmrc` 中添加：
loglevel=info
常用的级别包括：`silent`, `error`, `warn`, `notice`, `http`, `info`, `verbose`, `debug`。默认级别是 `notice`（在安装等操作中是 `info`）。
-
命令行覆盖：
你也可以通过命令行参数临时设置日志级别：
npm install –loglevel debug
配置并行安装数量 (Fetch Jobs)
控制 npm 在同一时间并发下载包的数量，可以影响安装速度和资源占用。
npm config set fetch-jobs 5
或在 `.npmrc` 中添加：
fetch-jobs=5
类似地，还有 `rebuild-jobs` 控制并行构建（compiling native add-ons）的数量。
配置全局安装路径 (Prefix)
`npm install -g
npm config set prefix /usr/local/npm-packages
或在 `.npmrc` 中添加：
prefix=/usr/local/npm-packages
这常用于解决在系统目录下安装全局包时遇到的权限问题。
配置优先级如何工作？
理解不同层级配置的优先级非常重要，尤其是当你发现某个配置似乎没有生效时。npm 会按照固定的顺序查找配置项，并使用它找到的第一个值。这个顺序从低到高是：
- 内置配置 (Built-in Defaults)
- 全局 `.npmrc` 文件 (`
/etc/npmrc`) - 用户级 `.npmrc` 文件 (`~/.npmrc`)
- 项目级 `.npmrc` 文件 (`/path/to/project/.npmrc`)
- 环境变量 (Environment Variables, `NPM_CONFIG_*`)
- 命令行参数 (Command-line Flags, `–config key=value` 或 `–key=value`)
例如，如果在 `~/.npmrc` 中设置了 `registry=https://registry.npmmirror.com/`，同时在项目根目录的 `.npmrc` 中设置了 `registry=https://my-private-registry.com/`，那么在该项目中运行 npm 命令时，`registry` 的值将是 `https://my-private-registry.com/`，因为它在项目级 `.npmrc` 文件中，优先级高于用户级。如果在运行命令时再带上 `–registry=https://another-registry.net/`，那么将使用命令行参数指定的值。
使用 `npm config list -l` 命令可以清晰地看到每个配置项的最终值以及它是从哪个文件或来源加载的，这是诊断配置问题最直接的方法。
管理 npm 配置的一些建议
- 项目特定配置使用 `.npmrc` 文件：对于仅适用于某个项目的配置（如私有注册表、构建脚本参数），在项目根目录创建 `.npmrc` 文件是最好的做法。这样配置会随项目一起，不会影响其他项目或全局环境。并将这个文件提交到版本控制（注意不要包含敏感信息）。
- 用户默认配置使用 `~/.npmrc`：将你常用的、希望在所有项目中都生效的配置（如默认注册表、代理）放在用户主目录的 `.npmrc` 文件中。
- 敏感信息使用环境变量：认证 token、密码等敏感信息不应该直接写在 `.npmrc` 文件中，尤其是在团队协作或开源项目中。优先使用环境变量来传递这些值，或者使用 npm 提供的安全方式（如 `npm login` 生成的 token，它在 `.npmrc` 中的格式相对更安全，但仍需注意 `.npmrc` 本身的权限）。
- 理解并利用配置优先级：当遇到配置冲突或某个配置没有生效时，回顾配置优先级规则，并使用 `npm config list -l` 来检查实际生效的配置值及其来源。
- 谨慎修改全局配置：全局配置会影响当前用户的所有 npm 操作。除非你确定所有项目都需要这个设置，否则尽量避免修改全局配置，或在修改前充分了解其影响。
通过合理地使用不同层级的配置方式，可以有效地管理 npm 的行为，提高开发效率并确保环境的稳定性。
