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 falsell和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 帮助内容。