npm 配置 Config

2021-10-29 10:52 更新

描述

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
  • llla命令: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。的唯一有效值accesspublic和 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 lsnpm outdated

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

description

  • 默认值:true
  • 类型:Boolean

显示说明 npm search

dev

  • 默认值:false
  • 类型:Boolean

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

dry-run

  • 默认值:false
  • 类型:Boolean

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

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-bundlinglegacy-bundling将是首选。

group

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

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

heading

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

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

https-proxy

  • 默认值:null
  • 类型:Url

用于传出 https 请求的代理。如果设置了HTTPS_PROXYor https_proxyHTTP_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

您要向其发送 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 lsnpm outdated, 或 npm update--dev. 当“prod”或“production”并且在npm install没有任何参数的情况下在本地运行时,只会安装非 devDependencies(及其依赖项)。 当“prod”或“production”并在本地运行时npm lsnpm 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 的“预发布”部分的前缀的“预发布标识符”。就像rc1.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针对此值进行屏蔽。因此,默认值分别是07550644

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

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号