npmrc

npm 配置文件

描述

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

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

有关可用配置选项的列表,请参阅 配置

文件

四个相关文件是:

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

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

prefix = ${HOME}/.npm-packages

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

通过在键名后添加 "[]" 来指定数组值。 例如:

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

注释

.npmrc 文件中的行以 ;# 字符开头时被解释为注释。 .npmrc 文件由 npm/ini 解析,npm/ini 指定此注释语法。

例如:

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

每个项目的配置文件

在项目中本地工作时,项目根目录中的 .npmrc 文件(即 node_modulespackage.json 的兄弟)将设置特定于该项目的配置值。

请注意,这仅适用于你正在运行 npm 的项目的根目录。 当你的模块发布时,它不起作用。 例如,你不能发布强制自身全局安装或安装在不同位置的模块。

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

每个用户的配置文件

$HOME/.npmrc (或 userconfig 参数,如果在环境或命令行中设置)

全局配置文件

$PREFIX/etc/npmrc(或 globalconfig 参数,如果在上面设置): 此文件是 key = value 参数的 ini 文件格式列表。 可以如上所述替换环境变量。

内置配置文件

path/to/npm/itself/npmrc

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

也可以看看

npm 中文网 - 粤ICP备13048890号