在线文档教程

yarn tag

Yarn标签

添加,删除或列出包装上的标签。

什么是标签?

分发标签(或分发标签)是一种用标签标记发布版本包的方法。您的软件包的用户可以使用此标签而不是版本号来安装它。

例如,如果您有稳定的发布渠道和canary版本渠道,则可以使用标签作为允许用户键入以下内容的方式:

yarn add your-package-name@stable yarn add your-package-name@canary

不同的标签有不同的含义:

  • latest:包的当前版本

  • stable:软件包的最新稳定版本,通常与最新版本相同,除非您有长期支持(LTS)

  • beta:在最新和/或稳定之前发布,用于在完成之前分享即将到来的更改。

  • canary:如果您的项目经常更新并依赖于许多人,您可能会使用它来共享更早的代码,那么可以使用预测试版。

  • dev:有时你希望能够通过注册表测试一个单一的修订版,而你仍然在处理事情,这对此很有用。

有些项目会在他们认为合适的地方制作自己的标签,或者替代更为标准的标签。比如next用的是一样的beta

尽管这些被广泛认为是“标准”标签,但唯一具有任何实际含义的是latest在没有指定版本时用于确定安装哪个版本。

注意事项

您不能使用与潜在版本号相匹配的标签,因为它们共享一个名称空间:

yarn add your-package-name@<version> yarn add your-package-name@<tag>

任何可以用作有效的semver范围的标签都将被拒绝。例如,你不能有一个标签命名v2.3,因为在semver它的意思是>=2.3.0 <2.4.0。

一般来说,避免使用看起来像版本的标签,他们通常只会混淆人们。

命令

yarn tag add <package>@<version> <tag>

<tag>为特定<version>的<package>添加一个名称。

yarn tag rm <package> <tag>

从<package>删除指定的<tag>标记不再使用。

注意:在将标签移动到包中的其他版本之前,您无需删除标签。最好不要。

yarn tag list [<package>]

列出所有的标签<package>。如果未指定<package>将默认为您目前位于目录中的包。