分发标签 (dist-tag) 是您用来组织和标记发布的不同包版本的易于理解的标签。dist-tag 补充了 语义版本控制。除了比语义版本编号更易于理解之外,标签还允许发布者更有效地分发其包。

有关更多信息,请参阅 dist-tag CLI 文档

注意:由于 dist-tag 与语义版本共享命名空间,因此请避免与现有版本号冲突的 dist-tag。我们建议避免以数字或字母 "v" 开头的 dist-tag。

使用 dist-tag 发布包

默认情况下,运行 npm publish 将使用 latest dist-tag 标记您的包。若要使用其他 dist-tag,请在发布时使用 --tag 标志。

  1. 在命令行中,导航到包的根目录。

    cd /path/to/package
  2. 运行以下命令,将 <tag> 替换为您要使用的标签

    npm publish --tag <tag>

示例

若要使用 "beta" dist-tag 发布包,请在命令行中,在包的根目录中运行以下命令

npm publish --tag beta

为包的特定版本添加 dist-tag

  1. 在命令行中,导航到包的根目录。

    cd /path/to/package
  2. 运行以下命令,将 <package_name> 替换为您的包名称,将 <version> 替换为您的包版本号,将 <tag> 替换为分发标签

    npm dist-tag add <package-name>@<version> [<tag>]

示例

若要为 "example-package" 包的 1.4.0 版本添加 "stable" 标签,您需要运行以下命令

npm dist-tag add [email protected] stable