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 附带的脚本在此处设置字段。这主要是为了分发维护人员以标准和一致的方式覆盖默认配置。