npm npmrc

npm 配置文件

描述

npm 从命令行、环境变量和npmrc文件中获取其配置设置。

该npm config命令可用于更新和编辑用户和全局 npmrc 文件的内容。

有关可用配置选项的列表，请参阅 config。

文件

四个相关文件是：

• 每个项目的配置文件（/path/to/my/project/.npmrc）
• 每个用户的配置文件 (~/.npmrc)
• 全局配置文件 ($PREFIX/etc/npmrc)
• npm 内置配置文件 (/path/to/npm/npmrc)

所有 npm 配置文件都是一个 ini 格式的key = value参数列表。环境变量可以使用${VARIABLE_NAME}. 例如：

prefix = ${HOME}/.npm-packages

加载这些文件中的每一个，并按优先级顺序解析配置选项。例如，userconfig 文件中的设置将覆盖 globalconfig 文件中的设置。

通过在键名后添加“[]”来指定数组值。例如：

key[] = "first value"
key[] = "second value"

注释

在线路.npmrc时，他们用开头的文件被解释为注释 ;或#字符。.npmrc文件由npm/ini解析 ，它指定了此注释语法。 例如：

## last modified: 01 Jan 2016
; Set a new registry for a scoped package
@myscope:registry=https://mycustomregistry.example.org

每个项目的配置文件

当一个项目在当地工作，一个.npmrc项目的根文件（即的兄弟node_modules和package.json）将设置配置值具体到这个项目中。

请注意，这仅适用于您在其中运行 npm 的项目的根目录。当您的模块发布时，它不起作用。例如，您不能发布强制自己在全球或不同位置安装的模块。

此外，此文件不会在全局模式下读取，例如在运行 npm install -g.

每个用户的配置文件

$HOME/.npmrc（或userconfig参数，如果在环境或命令行中设置）

全局配置文件

$PREFIX/etc/npmrc（或globalconfig参数，如果在上面设置）：此文件是一个 ini 文件格式的key = value参数列表。环境变量可以如上替换。

内置配置文件

path/to/npm/itself/npmrc

这是一个不可更改的“内置”配置文件，npm 在更新时保持一致。使用./configure npm 附带的脚本在此处设置字段。这主要是为了分发维护人员以标准和一致的方式覆盖默认配置。