分发标签(dist-tags)是可读标签,可以用来管理和标记发布包的不同版本。dist-tags补充语义版本控制。除了比语义版本编号更易读之外,标签允许发布者更有效的分发他们的包。
有关更多信息,请参阅dist-tagCLI文档。
注意:因为dist-tags与语义版本控制共享同一个命名空间,避免与已经存在的版本号产生冲突。我们建议避免dist-tags以数字或字母v开始。
发布带有dist-tag的包
默认情况,运行npm publish将会使用latestdist-tag标记您的包。要使用另一个dist-tag,在发包时使用--tag标志。
- 在命令行,导航到包的根目录。
cd /path/to/package
- 运行以下命令,用你想使用的的标签替换
<tag>
npm publish --tag <tag>
例子
发布一个有"beta" dist-tag的包,在命令行,在包的根目录运行以下命令:
npm publish --tag beta
给包的指定版本增加dist-tag
- 在命令行,导航到包的根目录。
cd /path/to/package
- 运行以下命令,用你包的名称替换
<package_name>,用你的包版本号替换<version>,用分发标签替换<tag>
npm dist-tag add <package_name>@<version> [<tag>]
例子
给1.4.0版本的example-package包添加"stable"标签,您可以运行以下命令:
npm dist-tag add example-package@1.4.0 stable