npm dist-tag

本文目录结构

npm dist-tag 功能

修改软件包分发标签

npm dist-tag 使用

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

aliases: dist-tags

npm dist-tag 说明

添加，删除和枚举包装上的分发标签：

• add

  • 使用指定的标记或指定的 –tag 配置（如果未指定）标记软件包的指定版本 。如果您在 auth-and-writes 上进行了双重身份验证，则需要在命令行中使用一次性密码 --otp <one-time password>。

• rm

  • 从包装中清除不再使用的标签。

• ls

  • 显示软件包的所有 dist 标签，默认为当前前缀中的软件包。

  如果未指定，则这是默认操作。

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

npm install <name>@<tag>

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

npm install --tag <tag>

这也适用于 npm dedupe。

latest 除非使用该 –tag 选项，否则发布软件包会将标签设置为已发布的版本 。

例如，npm publish --tag=beta。

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

npm dist-tag 目的

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

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

默认情况下，latestnpm 使用该标签来标识软件包的当前版本，并且 npm install <pkg>（无任何 @<version>或 @<tag> 指定符）安装该 latest 标签。

通常，项目仅将 latest 标记用于稳定的发行版本，而将其他标记用于不稳定的版本，例如预发行。

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

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

注意事项

该命令以前称为 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。

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