npm-unpublish

從註冊中心移除套件

選擇 CLI 版本

概要

npm unpublish [<package-spec>]

如需瞭解有關 npm 登錄檔如何處理取消發佈的詳細資訊,請參閱我們的 取消發佈政策

警告

如果您的目的是鼓勵使用者升級,或您不再想維護套件,請考慮改用 deprecate 指令。

說明

這會從登錄檔中移除套件版本,刪除其項目並移除 tarball。

如果您未 登入,npm 登錄檔將傳回錯誤。

如果您完全未指定套件名稱,將從目前目錄中的專案擷取要取消發佈的名稱和版本。

如果您指定套件名稱但未指定版本,或如果您移除所有套件版本,登錄檔將完全移除根套件項目。

即使您取消發佈套件版本,該特定名稱和版本組合也永遠無法重複使用。若要再次發佈套件,您必須使用新的版本號碼。如果您取消發佈整個套件,您可能在 24 小時過後才能發佈該套件的任何新版本。

組態

dry-run

  • 預設值:false
  • 類型:布林值

表示您不希望 npm 進行任何變更,且它應該只報告它會執行的動作。這可以傳遞給任何修改您當地安裝的指令,例如 installupdatededupeuninstall,以及 packpublish

注意:這不會受到其他與網路相關指令的尊重,例如 dist-tagsowner 等。

force

  • 預設值:false
  • 類型:布林值

移除各種針對不幸的副作用、常見錯誤、不必要的效能降低和惡意輸入的防護措施。

  • 允許在全域安裝中覆寫非 npm 檔案。
  • 允許 npm version 指令在不乾淨的 git 儲存庫上執行。
  • 允許使用 npm cache clean 刪除快取資料夾。
  • 允許安裝具有 engines 宣告的套件,這些宣告需要不同版本的 npm。
  • 允許安裝具有 engines 宣告的套件,這些宣告需要不同版本的 node,即使已啟用 --engine-strict
  • 允許 npm audit fix 安裝超出您所述相依範圍(包括 SemVer 主要變更)的模組。
  • 允許取消發佈已發佈套件的所有版本。
  • 允許將衝突的 peerDependencies 安裝在根專案中。
  • npm init 期間隱含設定 --yes
  • 允許在 npm pkg 中覆寫現有值
  • 允許取消發布整個套件(不只單一版本)。

如果您對想要執行的動作沒有明確概念,強烈建議您不要使用此選項!

workspace

  • 預設
  • 類型:字串(可以設定多次)

在當前專案設定的工作空間環境中執行命令,同時透過僅執行此設定選項定義的工作空間來進行篩選。

下列為 workspace 設定的有效值

  • 工作空間名稱
  • 工作空間目錄的路徑
  • 父工作空間目錄的路徑(將會選取該資料夾中的所有工作空間)

設定為 npm init 命令時,可以設定為尚未存在的資料夾,以建立資料夾並將其設定為專案中的全新工作空間。

此值不會匯出至子程序的環境。

workspaces

  • 預設:null
  • 類型:null 或布林值

設定為 true 以在所有設定的工作空間環境中執行命令。

明確設定為 false 將會導致 install 等命令完全忽略工作空間。未明確設定時

  • node_modules 樹狀結構上運作的命令(安裝、更新等)將會將工作空間連結至 node_modules 資料夾。- 在其他事項上運作的命令(測試、執行、發布等)將會在根專案上運作,除非workspace 設定中指定一個或多個工作空間。

此值不會匯出至子程序的環境。

另請參閱