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

說明

在套件上新增、移除和列舉發行標籤

新增：使用指定的標籤標記套件的指定版本，或未指定時使用 --tag 設定。如果您在 auth-and-writes 上啟用兩步驟驗證，則需要在指令列中包含一次性密碼，格式為 --otp <一次性密碼>，或根據您的 authtype 進行第二步驟驗證流程。
rm：清除套件中不再使用的標籤。如果您已在 auth-and-writes 上啟用雙重驗證，則需要使用 --otp <一次性密碼> 在命令列中包含一次性密碼，或根據您的 authtype 進行第二個驗證流程
ls：顯示套件的所有 dist-tag，預設為目前前綴中的套件。如果未指定任何動作，這將是預設動作。

在安裝套件時，可以使用標籤作為版本參考，而不是使用特定版本號碼

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 本身具有特殊意義。