修改包分發(fā)標簽

概要

npm dist-tag add <pkg>@<version> [<tag>]
npm dist-tag rm <pkg> <tag>
npm dist-tag ls [<pkg>]


aliases: dist-tags

描述

在包上添加、刪除和枚舉分發(fā)標簽：

• add：使用指定的標簽標記指定版本的包，如果未指定，則使用--tag配置。如果你對auth-and-writes進行兩因素身份驗證，那么你需要在命令行中使用--otp <one-time password>，或者在otp提示符下包含一次性密碼。
• rm：從包中清除不再使用的標記。如果對auth-and-writes進行雙因素身份驗證，則需要在命令行使用--otp<one-time password>，或者在otp提示符下包含一次性密碼。
• ls：顯示一個包的所有dist-tags，默認為當前前綴中的包。如果沒有指定任何操作，則這是默認操作。

安裝包時可以使用標簽作為對版本的引用，而不是使用特定的版本號：

npm install <name>@<tag>

安裝依賴項時，可以指定首選的標記版本：

npm install --tag <tag>

這也適用于npm dedupe.

latest除非使用該--tag選項，否則發(fā)布包會將標記設(shè)置為已發(fā)布版本?。例如，npm publish --tag=beta。

默認情況下，npm install <pkg>（不帶任何@<version>或@<tag>?說明符）安裝latest標簽。

目的

標簽可用于提供別名而不是版本號。

例如，一個項目可能會選擇有多發(fā)展的多個數(shù)據(jù)流，并為每個數(shù)據(jù)流使用不同的標簽，如stable,beta,dev,canary。通常，項目僅對latest穩(wěn)定發(fā)布版本使用該?標簽，而對不穩(wěn)定版本（例如預(yù)發(fā)布）使用其他標簽。

next某些項目使用該標簽來標識即將發(fā)布的版本。

除了latest，沒有任何標簽對 npm 本身有任何特殊意義

默認情況下，latest npm 使用該標簽來標識包的當前版本，并且 npm install<pkg>(不帶任何 @<version>或@<tag>說明符)安裝該lastest 標簽。

注意事項

這個命令過去被稱為npm tag，它只創(chuàng)建新標簽，因此有不同的語法。

標簽必須與版本號共享一個命名空間，因為它們在同一個槽中指定：npm install <pkg>@<version>vs?npm install <pkg>@<tag>。

可以解釋為有效 semver 范圍的標簽將被拒絕。例如，v1.4不能用作標簽，因為它被 semver 解釋為?>=1.4.0 <1.5.0.?請參閱 https://github.com/npm/npm/issues/6082。

避免標簽出現(xiàn) semver 問題的最簡單方法是使用不以數(shù)字或字母開頭的標簽v。

配置

workspace 工作區(qū)

• 默認：
• 類型：String（可多次設(shè)置）

允許在當前項目的已配置工作區(qū)的上下文中運行命令，同時通過僅運行此配置選項定義的工作區(qū)進行過濾。

workspace配置的有效值為：

• 工作區(qū)名稱
• 工作區(qū)目錄的路徑
• 父工作區(qū)目錄的路徑（將導(dǎo)致選擇所有嵌套工作區(qū)）

為該npm init命令設(shè)置時，可以將其設(shè)置為尚不存在的工作區(qū)的文件夾，以創(chuàng)建該文件夾并將其設(shè)置為項目中的全新工作區(qū)。

此值不會導(dǎo)出到子進程的環(huán)境中。

workspaces 工作區(qū)

• 默認值：false
• 類型：Boolean

啟用在所有已配置工作區(qū)的上下文中運行命令。

此值不會導(dǎo)出到子進程的環(huán)境中。