npm 配置 Config

描述

npm 从以下来源获取其配置值，按优先级排序：

命令行标志

将 --foo bar 放在命令行上会将 foo 配置参数设置为 bar。 --参数告诉 CLI 解析器停止读取标志。在--flag不指定任何值的情况下使用会将值设置为true。

例如：--flag1 --flag2会将两个配置参数都设置为true，而--flag1 --flag2 bar会将flag1设置为true，将flag2设置为bar。最后，--flag1 --flag2 -- bar将两个配置参数都设置为true，并将bar当作命令参数。

环境变量

任何以npm_config_开头的环境变量都将被解释为配置参数。例如，将 npm_config_foo=bar放在您的环境中会将foo 配置参数设置为bar. 任何未赋予值的环境配置都将赋予true值。配置值不区分大小写，因此NPM_CONFIG_FOO=bar的工作方式相同。但是，请注意，在 npm-scripts 中， npm 会设置自己的环境变量，而 Node 会更喜欢那些小写版本，而不是您可能设置的任何大写版本。有关详细信息，请参阅此问题。

请注意，您需要使用下划线而不是破折号，因此--allow-same-version 会变成npm_config_allow_same_version=true.

npmrc 文件

四个相关文件是：

• 每个项目的配置文件 ( /path/to/my/project/.npmrc)
• 每个用户的配置文件（默认为$HOME/.npmrc；
• 可通过 CLI 选项--userconfig或环境变量配置$NPM_CONFIG_USERCONFIG）全局配置文件（默认为$PREFIX/etc/npmrc；
• 可通过 CLI 选项--globalconfig或环境变量配置$NPM_CONFIG_GLOBALCONFIG）npm 的内置配置文件 ( /path/to/npm/npmrc)

有关更多详细信息，请参阅npmrc。

默认配置

运行npm config ls -l以查看一组 npm 内部的配置参数，如果未指定其他参数，则为默认值。

速记和其他 CLI 技巧

在命令行上解析以下速记：

• -v: --version
• -h, -?, --help, -H: --usage
• -s, --silent: --loglevel silent
• -q, --quiet: --loglevel warn
• -d: --loglevel info
• -dd, --verbose: --loglevel verbose
• -ddd: --loglevel silly``-g: --global``-C: --prefix
• -l: --long``-m: --message
• -p, --porcelain: --parseable
• -reg: --registry
• -f: --force
• -desc: --description
• -S: --save
• -P: --save-prod
• -D: --save-dev
• -O: --save-optional
• -B: --save-bundle
• -E: --save-exact
• -y: --yes
• -n: --yes false
• ll和la命令：ls --long

如果指定的配置参数明确解析为已知配置参数，则将其扩展为该配置参数。例如：

npm ls --par
## same as:
npm ls --parseable

如果多个单字符速记串在一起，并且得到的组合明确不是其他配置参数，那么它会扩展到其各个组成部分。例如：

npm ls -gpld
## same as:
npm ls --global --parseable --long --loglevel info

每个包的配置设置

运行脚本时（请参阅[npm-scripts](https://www.npmjs.cn/misc/scripts)参考资料），如果 config 参数为 <name>[@<version>]:<key>. 例如，如果 package.json 有这个：

{ "name" : "foo"
, "config" : { "port" : "8080" }
, "scripts" : { "start" : "node server.js" } }

server.js 是这样的：

http.createServer(...).listen(process.env.npm_package_config_port)

然后用户可以通过执行以下操作来更改行为：

npm config set foo:port 80

有关更多信息，请参阅package.json。

配置设置

access

• 默认： restricted
• 类型：Public

发布范围包时，访问级别默认为 restri发布范围包时，访问级别默认为restricted。如果您希望您的范围包公开可见（和可安装） set --access=public。的唯一有效值access是public和 restricted。无作用域的包的访问级别始终为public.

allow-same-version

• 默认值：false
• 类型：Boolean

防止在npm version用于将新版本设置为与当前版本相同的值时抛出错误。

always-auth

• 默认值：false
• 类型：Boolean

强制 npm 在访问注册表时始终需要身份验证，即使对于GET请求也是如此。

also

• 默认值：null
• 类型：String

当“dev”或“development”并在本地运行时npm shrinkwrap， npm outdated, 或npm update是--dev.

auth

• 默认值：true
• 类型：Boolean

当为“true”时，将审计报告与npm install运行一起提交到默认注册表和为范围配置的所有注册表。有关提交内容的详细信息，请参阅npm-audit的文档。

auth-level

• 默认： "low"
• 类型：'low', 'moderate', 'high','critical'``npm audit

以非零退出代码退出的最低漏洞级别。

auth-type

• 默认： 'legacy'
• 类型：'legacy', 'sso', 'saml','oauth'

与adduser/一起使用的身份验证策略login。

bin-links

• 默认： true
• 类型：Boolean

告诉 npm.cmd为包可执行文件创建符号链接（或Windows 上的垫片）。

设置为 false 使其不这样做。这可以用来解决一些文件系统不支持符号链接的事实，即使在表面上是 Unix 系统上。

browser

• 默认值：OS X: "open", Windows: "start", 其他:"xdg-open"
• 类型：String

由npm docs命令调用以打开网站的浏览器。

ca

• 默认值：npm CA 证书
• 类型：string、数组或空

到注册表的 SSL 连接受信任的证书颁发机构签名证书。值应采用 PEM 格式（Windows 称其为“Base-64 编码的 X.509 (.CER)”），换行符替换为字符串“\n”。例如：

ca="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----"

设置为null仅允许“已知”注册商，或特定 CA 证书仅信任该特定签名机构。 通过指定一组证书，可以信任多个 CA：

ca[]="..."
ca[]="..."

另请参阅strict-ssl配置。

cafile

• 默认值：null
• 类型：Path

包含一个或多个证书颁发机构签名证书的文件的路径。与 ca 设置类似，但允许多个 ca，以及将 ca 信息存储在磁盘上的文件中。

cache

• 默认值：Windows：%AppData%\npm-cache, posix:~/.npm
• 类型：Path

npm 缓存目录的位置。看 [npm-cache][]

cache-lock-stale

• 默认值：60000（1 分钟）
• 类型：Number

缓存文件夹锁定文件被视为陈旧之前的毫秒数。

cache-lock-retries

• 默认值：10
• 类型：Number

重试获取缓存文件夹锁定文件锁定的次数。

cache-lock-wait

• 默认值：10000（10 秒）
• 类型：Number

等待缓存锁定文件到期的毫秒数。

cache-max

• 默认值：无穷大
• 类型：Number

已弃用：此选项已被弃用，以支持--prefer-online. --cache-max=0是--prefer-online的别名。

cache-min

• 默认值：10
• 类型：Number

已弃用：此选项已被弃用，以支持--prefer-offline. --cache-min=9999 (or bigger)是--prefer-offline的别名。

cert

• 默认： null
• 类型：String

访问注册表时要传递的客户端证书。值应采用 PEM 格式（Windows 称其为“Base-64 编码的 X.509 (.CER)”），换行符替换为字符串“\n”。例如：

cert="-----BEGIN CERTIFICATE-----\nXXXX\nXXXX\n-----END CERTIFICATE-----"

它不是证书文件的路径（并且没有“certfile”选项）。

cidr

• 默认值:null
• 类型：string、array、null

这是使用npm token create 命令配置受限访问令牌时要使用的 CIDR 地址列表。

color

• 默认值：true
• 类型：Boolean 或 "always"

如果为 false，则从不显示颜色。如果"always"然后总是显示颜色。如果为 true，则仅打印 tty 文件描述符的颜色代码。

也可以使用环境更改此选项：当环境变量NO_COLOR设置为任何值时，颜色将被禁用。

depth

• 默认值：无穷大
• 类型：Number

深度为递归目录时去npm ls， npm cache ls和npm outdated。

对于npm outdated， 的设置Infinity将被视为0 因为它提供了更多有用的信息。要显示所有包和依赖项的过时状态，请使用大整数值，例如，npm outdated --depth 9999

description

• 默认值：true
• 类型：Boolean

显示说明 npm search

dev

• 默认值：false
• 类型：Boolean

dev-dependencies与软件包一起安装。

dry-run

• 默认值：false
• 类型：Boolean

表示您不希望 npm 进行任何更改并且它应该只报告它会做的事情。这可以传递到修改本地安装的任何命令中，例如，install，update， dedupe，uninstall。这是不是目前一些网络相关的命令，如兑现dist-tags，owner等等。

editor

• 默认值：EDITOR环境变量（如果已设置）、"vi"Posix 或"notepad"Windows。
• 类型：Path

为npm editor运行的命令npm config edit。

engine-strict

• 默认值：false
• 类型：Boolean

如果设置为 true，那么 npm 将顽固地拒绝安装（甚至考虑安装）任何声称与当前 Node.js 版本不兼容的包。

force

• 默认值：false
• 类型：Boolean

使各种命令更有力:

• 生命周期脚本失败不会阻止进度。
• 发布clobbers以前发布的版本。
• 从注册表请求时跳过缓存。
• 防止检查破坏非 npm 文件。

fetch-retries

• 默认值：2
• 类型：Number

retry从注册表中获取包时要使用的模块的“重试”配置。

fetch-retry-factor

• 默认值：10
• 类型：Number

retry模块在获取包时使用的“因子”配置。

fetch-retry-mintimeout

• 默认值：10000（10 秒）
• 类型：Number

retry模块在获取包时使用的“minTimeout”配置。

fetch-retry-maxtimeout

• 默认值：60000（1 分钟）
• 类型：Number

retry模块在获取包时使用的“maxTimeout”配置。

git

• 默认： "git"
• 类型：String

用于 git 命令的命令。如果 git 安装在计算机上，但不在 中PATH，则将其设置为 git 二进制文件的完整路径。

git-tag-version

• 默认： true
• 类型：Boolean

使用npm version命令时标记提交。

commit-hooks

• 默认： true
• 类型：Boolean

使用npm version命令时运行 git commit hooks 。

global

• 默认值：false
• 类型：Boolean

在“全局”模式下运行，以便将包安装到 prefix文件夹而不是当前工作目录中。有关[npm-folders](https://www.npmjs.cn/files/folders)行为差异的更多信息，请参阅 。 软件包安装到{prefix}/lib/node_modules文件夹中，而不是当前工作目录中。bin 文件链接到 {prefix}/bin手册页链接到 {prefix}/share/man

globalconfig

• 默认值：{prefix}/etc/npmrc
• 类型：Path

要读取全局配置选项的配置文件。

global-style

• 默认值：false
• 类型：Boolean

使 npm 以node_modules与全局node_modules文件夹相同的布局将包安装到本地文件夹中。只有您的直接依赖项会显示在其中，node_modules并且它们所依赖的所有内容都将在其node_modules文件夹中展平。这显然会消除一些重复数据删除。如果与 一起使用legacy-bundling，legacy-bundling将是首选。

group

• 默认值：当前进程的 GID
• 类型：String 或 Number

以 root 用户身份在全局模式下运行包脚本时要使用的组。

heading

• 默认： "npm"
• 类型：String

启动所有调试日志输出的字符串。

https-proxy

• 默认值：null
• 类型：Url

用于传出 https 请求的代理。如果设置了HTTPS_PROXYor https_proxy或HTTP_PROXYorhttp_proxy环境变量，则底层request库将遵循代理设置。

if-present

• 默认值：false
• 类型：Boolean

如果为真，NPM不会有错误代码时退出run-script被调用未在定义脚本scripts的部分package.json。当需要有选择地运行存在的脚本并在脚本失败时失败时，可以使用此选项。这很有用，例如，在运行可能仅适用于其他通用 CI 设置中的某些构建的脚本时。

ignore-prepublish

• 默认值：false
• 类型：Boolean

如果为 true，npm 将不会运行prepublish脚本。

ignore-scripts

• 默认值：false
• 类型：Boolean

如果为 true，则 npm 不会运行 package.json 文件中指定的脚本。

init-module

• 默认值：~/.npm-init.js
• 类型：Path

将由npm init命令加载的模块。有关更多信息，请参阅init-package-json模块的文档 或npm-init。

init-author-name

• 默认： ””
• 类型：String

该值npm init应该由默认包的作者的名字使用。

init-author-email

• 默认： ””
• 类型：String

该值npm init应该是默认对于包的作者的电子邮件使用。

init-author-url

• 默认： ””
• 类型：String

该值npm init应该由默认包作者的主页使用。

init-license

• 默认值：“ISC”
• 类型：String

该值npm init应为默认包许可使用。

init-version

• 默认值：“1.0.0”
• 类型：Semver

该值npm init应该默认软件包版本号使用，如果在的package.json尚未设置。

json

• 默认值：false
• 类型：boolean

是否输出JSON数据，而不是正常输出。 此功能目前处于试验阶段，许多命令的输出数据结构尚未在 JSON 中实现，或者可能会发生变化。只有来自npm ls --json和的输出npm search --json当前有效。

key

• 默认： null
• 类型：String

访问注册表时要传递的客户端密钥。值应为 PEM 格式，换行符替换为字符串“\n”。例如：

key="-----BEGIN PRIVATE KEY-----\nXXXX\nXXXX\n-----END PRIVATE KEY-----"

它不是密钥文件的路径（并且没有“密钥文件”选项）。

legacy-bunding

• 默认值：false
• 类型：Boolean

使 npm 安装包，以便 1.4 之前的 npm 版本，例如 node 0.8 中包含的版本，可以安装该包。这消除了所有自动重复数据删除。如果与global-style此选项一起使用将是首选。

link

• 默认值：false
• 类型：Boolean

如果为 true，则本地安装将链接是否有合适的全局安装包。 请注意，这意味着本地安装可能会导致同时将事物安装到全局空间中。仅当满足两个条件之一时才完成链接： 该软件包尚未全局安装，或全局安装的版本与本地安装的版本相同。

local-address

• 默认值：undefined
• 类型：IP 地址

连接到 npm 注册表时要使用的本地接口的 IP 地址。在 0.12 之前的 Node 版本中必须是 IPv4。

loglevel

• 默认值："notice"
• 类型：String
• 值：“silent”、“error”、“warn”、“notice”、“http”、“timing”、“info”、“verbose”、“silly”

要报告的日志级别。失败时，所有日志都写入 npm-debug.log当前工作目录。 显示任何高于设置级别的日志。默认值为“通知”。

logstream

• 默认值：process.stderr
• 类型：Stream

这是在运行时传递给npmlog模块的流 。 它不能从命令行设置，但如果您以编程方式使用 npm，您可能希望将日志发送到 stderr 以外的其他地方。 如果color配置设置为 true，则此流将接收彩色输出（如果它是 TTY）。

logs-max

• 默认值：10
• 类型：Number

要存储的最大日志文件数。

long

• 默认值：false
• 类型：Boolean

在npm ls和 中显示扩展信息npm search。

maxsockets

• 默认值：50
• 类型：Number

每个源使用的最大连接数（协议/主机/端口组合）。传递给http Agent用于发出请求的对象。

message

• 默认值："%s"
• 类型：String

npm version创建版本提交时使用的提交消息。 消息中的任何“%s”都将替换为版本号。

metrics-registry

• 默认值：registry的值（默认为“https://registry.npmjs.org/”）
• 类型：String

您要向其发送 cli 指标的注册表是否send-metrics为 true。

node-options

• 默认值：null
• 类型：String

通过NODE_OPTIONS环境变量传递到 Node.js 的选项。这不会影响 npm 本身的执行方式，但会影响生命周期脚本的调用方式。

node-version

• 默认值：process.version
• 类型：semver 或 false

检查包的engines映射时要使用的节点版本。

noproxy

• 默认值：null
• 类型：String 或 Array

不应使用代理的逗号分隔字符串或域扩展数组。

offline

• 默认值：false
• 类型：Boolean

强制离线模式：安装过程中不会进行网络请求。要允许 CLI 填充丢失的缓存数据，请参阅--prefer-offline。

onload-script

• 默认值：false
• 类型：Path

require()npm 加载时的节点模块。对编程使用很有用。

only

• 默认值：null
• 类型：String

当 "dev" 或 "development" 并且在npm install没有任何参数的情况下在本地运行时，只会安装 devDependencies（及其依赖项）。 当“dev”或“development”并在本地运行时npm ls，npm outdated, 或 npm update是--dev. 当“prod”或“production”并且在npm install没有任何参数的情况下在本地运行时，只会安装非 devDependencies（及其依赖项）。 当“prod”或“production”并在本地运行时npm ls，npm outdated, 或 npm update是--production.

optional

• 默认值：true
• 类型：Boolean

尝试在optionalDependencies对象中安装包。请注意，如果这些软件包安装失败，则不会中止整个安装过程。

otp

• 默认值：null
• 类型：Number

这是来自两因素身份验证器的一次性密码。使用npm access.

package-lock

• 默认值：true
• 类型：Boolean

如果设置为 false，则package-lock.json在安装时忽略文件。如果为真，这也将阻止写入 。package-lock.json``save

当包包锁被禁用时，无关模块的自动修剪也将被禁用。要删除禁用包锁的无关模块，请使用npm prune. 此选项是 的别名--shrinkwrap。

package-lock-only

• 默认值：false
• 类型：Boolean

如果设置为 true，它将只更新package-lock.json，而不是检查node_modules和下载依赖项。

parseable

• 默认值：false
• 类型：Boolean

从写入标准输出的命令输出可解析的结果。对于npm search，这将是制表符分隔的表格格式。

prefer-offline

• 默认值：false
• 类型：Boolean

如果为 true，将绕过对缓存数据的陈旧检查，但将从服务器请求丢失的数据。要强制完全离线模式，请使用--offline.

此选项实际上等效于--cache-min=9999999.

prefer-online

• 默认值：false
• 类型：Boolean

如果为 true，则将强制对缓存数据进行陈旧性检查，从而使 CLI 立即查找更新，即使是新的包数据。

prefix

• 默认值：请参阅 npm 文件夹
• 类型：path

安装全局项的位置。如果在命令行上设置，则它会强制非全局命令在指定文件夹中运行。

preid

• 默认： ""
• 类型：String

用作 semver 的“预发布”部分的前缀的“预发布标识符”。就像rc在1.2.0-rc.8.

production

• 默认值：false
• 类型：Boolean

设置为 true 以在“生产”模式下运行。 在npm install没有任何参数的情况下运行本地时，devDependencies 不会安装在最顶层。为生命周期脚本设置 NODE_ENV="production"。

progress

• 默认值：true，除非设置了 TRAVIS 或 CI env vars。
• 类型：Boolean

设置为true时，如果process.stderr是 TTY ，npm 将在时间密集型操作期间显示进度条。 设置为false抑制进度条。

proxy

• 默认值：null
• 类型：Url

用于传出 http 请求的代理。如果设置了HTTP_PROXY或 http_proxy环境变量，则底层request库将遵循代理设置。

read-only

• 默认值：false
• 类型：Boolean

这用于在使用npm token create命令配置受限访问令牌时将令牌标记为无法发布。

rebuild-bundle

• 默认值：true
• 类型：Boolean

安装后重建捆绑的依赖项。

registry

• 默认值：https : //registry.npmjs.org/
• 类型：Url

npm 包注册表的基本 URL。

rollback

• 默认值：true
• 类型：Boolean

删除失败的安装。

save

• 默认值：true
• 类型：Boolean

将已安装的包作为依赖项保存到 package.json 文件中。 当与npm rm命令一起使用时，它会将它从dependencies 对象中删除。 仅当存在 package.json 文件时才有效。

save-bundle

• 默认值：false
• 类型：Boolean

如果一个软件包将在通过使用安装时被保存--save， --save-dev或者--save-optional，那么也把它在 bundleDependencies列表中。 与该npm rm命令一起使用时，它会将其从 bundledDependencies 列表中删除。

save-prod

• 默认值：false
• 类型：Boolean

确保一个包将被dependencies专门保存到。如果包已经存在于devDependencies或 中 optionalDependencies，但您想将其移动为生产部门，则这很有用。如果--save为真，则这也是默认行为，两者都不为真--save-dev或 --save-optional都为真。

save-dev

• 默认值：false
• 类型：Boolean

将已安装的包作为 .json 文件保存到 package.json 文件中devDependencies。 当与npm rm命令一起使用时，它会将它从devDependencies对象中删除 。 仅当存在 package.json 文件时才有效。

save-exact

• 默认值：false
• 类型：Boolean

使用--save,保存到 package.json 的依赖项，--save-dev或者 --save-optional将使用确切版本而不是使用 npm 的默认 semver 范围运算符进行配置。

save-optional

• 默认值：false
• 类型：Boolean

将已安装的软件包作为 optionalDependencies 保存到 package.json 文件中。 当与npm rm命令一起使用时，它会将它从devDependencies对象中删除 。 仅当存在 package.json 文件时才有效。

save-prefix

• 默认值：'^'
• 类型：String

配置安装到 package.json 文件的软件包版本如何通过 --save或--save-dev获得前缀。 例如，如果一个包有 version 1.2.3，默认情况下它的 version 被设置为^1.2.3允许对该包进行次要升级，但之后 npm config set save-prefix='~'它会被设置为~1.2.3只允许补丁升级。

scope

• 默认值：当前项目的范围，如果有，或""
• 类型：String

将操作与作用域注册表的作用域相关联。首次登录私有注册表时很有用： npm login --scope=@organization --registry=registry.organization.com，这将导致@organization映射到注册表，以便将来安装根据模式指定的软件包@organization/package。

script-shell

• 默认：null
• 类型：Path

用于脚本的 shell 与npm run命令一起运行。

scripts-prepent-node-path

• 默认值："warn-only"
• 类型：Boolean，"auto"或"warn-only"

如果设置为true，则在运行脚本时将当前node可执行文件所在的目录添加到PATH环境变量中，即使这意味着npm将调用node与其正在运行的可执行文件不同的可执行文件。 如果设置为false，则永远不要修改PATH。 如果设置为"warn-only"，则永远不要修改，PATH但如果npm认为您可能想用 运行它，则打印警告true，例如，因为 中的node可执行文件PATH不是npm被调用的可执行文件。 如果设置为auto，则仅PATH当调用的node可执行文件与npm第一个在 上找到的可执行文件不同时，才将该目录添加到环境变量中PATH。

searchexclude

• 默认： ""
• 类型：String

限制搜索结果的空格分隔选项。

serchopts

• 默认： ""
• 类型：String

始终传递给搜索的空格分隔选项。

searchlimit

• 默认值：20
• 类型：number

限制搜索结果的项目数。根本不适用于旧版搜索。

searchstaleness

• 默认值：900（15 分钟）
• 类型：Number

如果使用旧搜索端点，则在发出另一个注册表请求之前缓存的年龄（以秒为单位）。

send-metrics

• 默认值：false
• 类型：Boolean

如果为 true，成功/失败指标将报告给存储在 metrics-registry. 这些请求包含 npm CLI 运行成功和失败的次数以及收集这些计数的时间段。这些请求中不包含识别信息。

shell

• 默认值：SHELL 环境变量，或 Posix 上的“bash”，或 Windows 上的“cmd”
• 类型：Path

为npm explore命令运行的 shell 。

shrinkwrap

• 默认值：true
• 类型：Boolean

如果设置为 false，则npm-shrinkwrap.json在安装时忽略文件。如果为真，这也将阻止写入 。npm-shrinkwrap.json``save 此选项是 的别名--package-lock。

sign-git-commit

• 默认值：false
• 类型：Boolean

如果设置为 true，则该npm version命令将使用-S添加签名来提交新的包版本。 请注意，git 要求您在 git 配置中设置 GPG 密钥才能正常工作。

sign-git-tag

• 默认值：false
• 类型：Boolean

如果设置为 true，则该npm version命令将使用-s添加签名来标记版本。 请注意，git 要求您在 git 配置中设置 GPG 密钥才能正常工作。

sso-frequency

• 默认值：500
• 类型：Number

当与启用 SSO 的auth-types 一起使用时，配置在用户完成身份验证时应该多久轮询注册表。

sso-type

• 默认值：'oauth'
• 类型：'oauth'、'saml' 或 null

如果--auth-type=sso，要使用的 SSO 类型的类型。

strict-ssl

• 默认值：true
• 类型：Boolean

通过 https 向注册中心发出请求时是否进行 SSL 密钥验证。 另请参阅ca配置。

tag

• 默认值："latest"
• 类型：String

如果你要求 npm 安装一个包并且没有告诉它一个特定的版本，那么它会安装指定的标签。 npm tag如果未给出显式标签，则也是添加到命令指定的 package@version 的标签。

tag-version-perfix

• 默认值： "v"
• 类型：String

如果设置，则在使用 执行版本增量时更改标记新版本时使用的前缀 npm-version。要完全删除前缀，将其设置为空字符串：""。 因为其他工具可能依赖于 npm 版本标记看起来像的约定 v1.0.0，所以只有在绝对必要时才使用此属性。特别是，在为公共包覆盖此设置时要小心。

timing

• 默认值： false
• 类型：Boolean

如果为 true，则将npm-debug日志_logs和计时信息 写入_timing.json缓存中。 _timing.json是一个以换行符分隔的 JSON 对象列表。您可以使用此json命令行快速查看它 ： json -g < ~/.npm/_timing.json.

tmp

• 默认值：TMPDIR 环境变量，或“/tmp”
• 类型：Path

存储临时文件和文件夹的位置。所有临时文件在成功时都会被删除，但为了取证目的而在失败时被保留。

unicode

• 默认值：在 Windows 上为 false，在具有 unicode 语言环境的 mac/unix 系统上为 true
• 类型：Boolean

当设置为 true 时，npm 在树输出中使用 unicode 字符。当为 false 时，它​​使用 ascii 字符来绘制树。

unsafe-perm

• 默认值：如果以 root 身份运行，则为 false，否则为 true
• 类型：Boolean

设置为 true 以在运行包脚本时禁止 UID/GID 切换。如果显式设置为 false，则以非 root 用户身份安装将失败。

update-notifier

• 默认值：true
• 类型：Boolean

设置为 false 以在使用较旧版本的 npm 时抑制更新通知。

usage

• 默认值：false
• 类型：Boolean

设置为在执行npm-help.

user

• 默认值："nobody"
• 类型：String 或 Number

以 root 身份运行包脚本时要设置的 UID。

userconfig

• 默认值：~/.npmrc
• 类型：Path

用户级配置设置的位置。

umask

• 默认值：022
• 类型：范围为 0000..0777 (0..511) 的八进制数字字符串

在文件和文件夹上设置文件创建模式时要使用的“umask”值。 文件夹和可执行文件被赋予一种模式，该模式0777针对此值进行屏蔽。其他文件被赋予一种模式，该模式0666针对此值进行屏蔽。因此，默认值分别是0755和0644。

user-agent

• 默认值：node/{process.version} {process.platform} {process.arch}
• 类型：String

将用户代理设置为请求标头

version

• 默认值：false
• 类型：Boolean

如果为 true，则输出 npm 版本并成功退出。 仅在命令行上明确指定时才相关。

versions

• 默认值：false
• 类型：Boolean

如果为 true，则输出 npm 版本以及节点的process.versions映射，并成功退出。 仅在命令行上明确指定时才相关。

viewer

• 默认值：Posix 上的"man"，Windows 上的"browser"
• 类型：Path

用于查看帮助内容的程序。 设置为"browser"在默认 Web 浏览器中查看 html 帮助内容。