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 开头的标签。