npm 分發(fā)標(biāo)簽 dist-tag

修改包分發(fā)標(biāo)簽

概要

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


aliases: dist-tags

描述

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

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

安裝包時(shí)可以使用標(biāo)簽作為對版本的引用，而不是使用特定的版本號：

npm install <name>@<tag>

安裝依賴項(xiàng)時(shí)，可以指定首選的標(biāo)記版本：

npm install --tag <tag>

這也適用于npm dedupe.

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

默認(rèn)情況下，npm install <pkg>（不帶任何@<version>或@<tag>?說明符）安裝latest標(biāo)簽。

目的

標(biāo)簽可用于提供別名而不是版本號。

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

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

除了latest，沒有任何標(biāo)簽對 npm 本身有任何特殊意義

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

注意事項(xiàng)

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

標(biāo)簽必須與版本號共享一個(gè)命名空間，因?yàn)樗鼈冊谕粋€(gè)槽中指定：npm install <pkg>@<version>vs?npm install <pkg>@<tag>。

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

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

配置

workspace 工作區(qū)

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

允許在當(dāng)前項(xiàng)目的已配置工作區(qū)的上下文中運(yùn)行命令，同時(shí)通過僅運(yùn)行此配置選項(xiàng)定義的工作區(qū)進(jìn)行過濾。

workspace配置的有效值為：

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

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

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

workspaces 工作區(qū)

• 默認(rèn)值：false
• 類型：Boolean

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

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