本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

npm 标签处理

npm 注册表支持标签，这些标签是程序包版本的字符串别名。您可以使用标签来提供别名而不是提供版本号。例如，您可能有一个包含多个开发流的项目，并且为每个流使用不同的标签（例如 stable、beta、dev、canary）。有关更多信息，请参阅 npm 网站上的 dist-tag。

默认情况下，npm 使用 latest 标签来标识程序包的当前版本。npm install pkg（不带 @version 或 @tag 说明符）会安装最新的标签。通常，项目仅对稳定版本使用最新标签。对于不稳定版本或预发行版本使用其他标签。

使用 npm 客户端编辑标签

三个 npm dist-tag 命令（add、rm 和 ls）在 CodeArtifact 存储库中的功能与在默认 npm 注册表中的功能相同。

npm 标签和 CopyPackageVersions API

当您使用 CopyPackageVersions API 来复制 npm 程序包版本时，所有作为该版本别名的标签都会复制到目标存储库。如果要复制的版本的标签也存在于目标存储库中，则复制操作会将目标存储库中的标签值设置为与源存储库中的值相匹配。

例如，假设存储库 S 和存储库 D 都包含 web-helper 程序包的一个版本，其最新标签设置如下表所示。

调用 CopyPackageVersions 来将 web-helper 1.0.1 从 S 复制到 D。操作完成后，存储库 D 中 web-helper 的 latest 标签别名为 1.0.1，而不是 1.0.0。

如果在复制后需要更改标签，请使用 npm dist-tag 命令直接在目标存储库中修改标签。有关 CopyPackageVersions API 的更多信息，请参阅在存储库之间复制程序包。

npm 标签和上游存储库

当 npm 请求程序包的标签且上游存储库也存在该程序包的版本时，CodeArtifact 会合并标签，然后再将标签返回给客户端。例如，名为 R 的存储库有一个名为 U 的上游存储库。下表显示了两个存储库中都存在的名为 web-helper 的程序包的标签。

在这种情况下，当 npm 客户端从存储库 R 获取 web-helper 程序包的标签时，它会同时收到最新标签和 alpha 标签。标签指向的版本不会改变。

当上游和下游存储库中的同一个程序包存在相同的标签时，CodeArtifact 会使用上游存储库中存在的标签。例如，假设 webhelper 上的标签已修改为如下所示。

在这种情况下，当 npm 客户端从存储库 R 提取程序包 web-helper 的标签时，因为上游存储库中存在最新标签，所以该标签将作为版本 1.0.1 的别名。这样就可以运行 npm update，在上游存储库中更轻松地使用尚不存在于下游存储库中的新程序包版本。

在下游存储库中发布程序包的新版本时，在上游存储库中使用该标签会出现问题。例如，假设程序包 web-helper 的最新标签在 R 和 U 中相同。

当版本 1.0.2 发布到 R 时，npm 会将最新标签更新为 1.0.2。

但是，因为 U 中的最新值是 1.0.1，所以 npm 客户端永远看不到这个标签值。发布 1.0.2 后立即对存储库 R 运行 npm install 会安装 1.0.1，而不是安装刚刚发布的版本。要安装最新发布的版本，必须指定确切的程序包版本，如下所示。

npm install web-helper@1.0.2