npm-dist-tag
修改包分发标签概要
npm dist-tag add <pkg>@<version> [<tag>]npm dist-tag rm <pkg> <tag>npm dist-tag ls [<pkg>]aliases: dist-tags
描述
在包上添加、删除和枚举分发标签:
add: 使用指定的标记标记指定版本的包,如果未指定,则标记
--tag
配置。 如果你在 auth-and-writes 上有双重身份验证,那么你需要在命令行中使用--otp <one-time password>
包含一次性密码。rm: 清除封装中不再使用的标签。
ls: 显示包的所有 dist-tags,默认为当前前缀中的包。 如果未指定,则这是默认操作。
安装包时可以使用标记作为对版本的引用,而不是使用特定的版本号:
npm install <name>@<tag>
安装依赖时,可以指定首选标记版本:
npm install --tag <tag>
这也适用于 npm dedupe
。
除非使用 --tag
选项,否则发布包会将 latest
标记设置为已发布版本。 例如,npm publish --tag=beta
。
默认情况下,npm install <pkg>
(没有任何 @<version>
或 @<tag>
说明符)安装 latest
标签。
目的
标签可用于提供别名而不是版本号。
例如,一个项目可能选择有多个开发流并为每个流使用不同的标签,例如,stable
、beta
、dev
、canary
。
默认情况下,npm 使用 latest
标签来标识包的当前版本,而 npm install <pkg>
(没有任何 @<version>
或 @<tag>
说明符)安装 latest
标签。 通常,项目只使用 latest
标签表示稳定版本,而使用其他标签表示不稳定版本,例如 prereleases。
一些项目使用 next
标签来标识即将发布的版本。
默认情况下,除了 latest
之外,没有任何标签对 npm 本身具有任何特殊意义。
注意事项
该命令以前称为 npm tag
,它只创建新标签,因此具有不同的语法。
标签必须与版本号共享一个命名空间,因为它们是在同一个插槽中指定的: npm install <pkg>@<version>
对 npm install <pkg>@<tag>
。
可以解释为有效 semver 范围的标签将被拒绝。 例如,v1.4
不能用作标签,因为它被 semver 解释为 >=1.4.0 <1.5.0
。 见 https://github.com/npm/npm/issues/6082。
避免标签出现语义问题的最简单方法是使用不以数字或字母 v
开头的标签。