NPM-dist的标签

概要

npm dist-tag add <pkg>@<version> [<tag>]
npm dist-tag rm <pkg> <tag>
npm dist-tag ls [<pkg>]

aliases: dist-tags

描述

在包上添加，删除和枚举分发标记：

• add：使用指定的标记标记包的指定版本，--tag如果未指定，则标记 配置。如果您要添加的标记是latest并且您在 auth-and-writes 上有双因素身份验证，那么您需要在命令行中包含 otp --otp。
• rm：清除包中不再使用的标记。
• ls：显示包的所有 dist-tag，默认为当前前缀中的包。

安装包作为对版本的引用而不是使用特定版本号时，可以使用标记：

npm install <name>@<tag>

安装依赖项时，可以指定首选标记版本：

npm install --tag <tag>

这也适用于npm dedupe。

latest除非使用该--tag选项，否则发布包会将标记设置为已发布的版本 。例如，npm publish --tag=beta。

默认情况下，npm install <pkg>（不带任何@<version>或@<tag> 说明符）安装latest标记。

目的

标签可用于提供别名而不是版本号。

例如，一个项目可能会选择有发展的多个数据流，并使用不同的标签为每个数据流，如stable，beta，dev，canary。

默认情况下，latestnpm 使用标记来标识包的当前版本，并且npm install <pkg>（不带任何@<version>或@<tag> 说明符）安装latest标记。通常，项目仅将latest 标记用于稳定版本，并将其他标记用于不稳定版本（如预发行版）。

next某些项目使用该标记来标识即将发布的版本。

默认情况下，除了latest没有标签对 npm 本身有任何特殊意义。

CAVEATS

此命令曾经被称为npm tag，只创建了新标记，因此具有不同的语法。

标签必须与版本号共享命名空间，因为它们在同一插槽中指定：npm install <pkg>@<version>vs npm install <pkg>@<tag>。

可以被解释为有效的semver范围的标签将被拒绝。例如，v1.4不能用作标记，因为它被semver解释为 >=1.4.0 <1.5.0。请参阅https://github.com/npm/npm/issues/6082。

避免标签出现 semver 问题的最简单方法是使用不以数字或字母开头的标签v。