npm-dist-tag

修改包分发标签

选择 CLI 版本

概要

npm dist-tag add <package-spec (with version)> [<tag>]
npm dist-tag rm <package-spec> <tag>
npm dist-tag ls [<package-spec>]

alias: dist-tags

描述

在包上添加、删除和枚举分发标签

add: 使用指定的标签标记包的指定版本，或者--tag 配置（如果未指定）。如果你在 auth-and-writes 上启用了双因素身份验证，则需要在命令行中使用 --otp <一次性密码> 包含一次性密码，或者根据你的 authtype 经历二次验证流程。
rm: 从包中清除不再使用的标签。如果你在 auth-and-writes 上启用了双因素身份验证，则需要在命令行中使用 --otp <一次性密码> 包含一次性密码，或者根据你的 authtype 经历二次验证流程。
ls: 显示包的所有分发标签，默认显示当前前缀中的包。如果没有指定任何操作，则为默认操作。

标签可以在安装包时用作版本引用，而不是使用特定的版本号。

npm install <name>@<tag>

在安装依赖项时，可以指定首选的带标签版本。

npm install --tag <tag>

(这也适用于任何其他解析和安装依赖项的命令，例如 npm dedupe、npm update 和 npm audit fix)。

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

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

目的

标签可以用来提供别名，而不是版本号。

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

默认情况下，npm 使用 latest 标签来识别包的当前版本，并且 npm install <pkg>（不带任何 @<version> 或 @<tag> 指定符）会安装 latest 标签。通常，项目只对稳定发布版本使用 latest 标签，而对不稳定版本（如预发布版本）使用其他标签。

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

除了 latest 之外，没有哪个标签对 npm 本身有任何特殊意义。