作為套件擁有者或協作者,如果您的套件沒有依賴項,您可以使用 CLI 永久從 npm 註冊表中移除它。您可以在最初發布後 72 小時內取消發布;超過 72 小時後,您仍然可以取消發布您的套件,如果它符合某些條件

這些條件設定為避免損害 JavaScript 套件生態系統。如果您無法取消發布您的套件,您可以改為不建議使用

注意:從套件中移除所有協作者或團隊不會取消發布它。

取消發布套件

如果您想從註冊表中完全移除所有版本的套件,您可以完全取消發布它。這將從註冊表中刪除它,並且無法安裝它。

若要取消發布套件,您必須符合套件取消發布規則的要求。

使用網站

  1. 在 npm "登入" 頁面,輸入您的帳戶詳細資料,然後按一下 登入 npm 登入對話框螢幕截圖
  2. 導航至您要取消發布的套件的套件頁面,將 <your-package-name> 替換為您的套件名稱:https://www.npmjs.com/package/<your-package-name>

  3. 按一下 設定

    Screenshot showing the admin tab on a package page
  4. 在「刪除套件」下方,按一下 刪除套件

    Screenshot showing the admin tab on a package page

    注意:如果您無法刪除套件,因為它不符合取消發布要求,則刪除套件選項將不可用。相反地,系統會提示您棄用套件

  5. 如果您確定要繼續,請輸入您的套件名稱,然後按一下 刪除套件

    Screenshot showing the admin tab on a package page

使用命令列

若要取消發布整個套件,請執行以下命令,將 <package-name> 替換為您的套件名稱

npm unpublish <package-name> -f

如果您已為寫入啟用雙重驗證,您需要將一次性密碼新增至 unpublish 命令,--otp=123456(其中 123456 是來自您的驗證器應用程式的代碼)。

如果您需要協助取消發布您的套件,請聯絡 npm 支援。如果您是企業客戶,請聯絡企業支援

注意:如果您取消發布整個套件,您可能無法在 24 小時內發布任何新版本的該套件。

取消發布套件的單一版本

如果您想移除套件的單一版本,您可以取消發布一個版本,而不影響其他版本。這將僅從註冊表中刪除該版本,並且無法安裝它。此選項僅透過 npm CLI 提供。

使用命令列

若要取消發布套件的單一版本,請執行以下命令,將 <package-name> 替換為您的套件名稱,以及 <version> 替換為您的版本號碼

npm unpublish <package-name>@<version>

何時取消發布

取消發布套件會永久從註冊表中移除套件,因此其他使用者無法再安裝。套件取消發布後,在 24 小時內無法使用相同名稱重新發布。如果您錯誤地取消發布套件,我們建議您使用不同的名稱重新發布,或對於未發布的版本,增加版本號碼並重新發布。

您可能想要取消發布套件,因為您

  • 意外發布了某些內容。
  • 想要測試 npm。
  • 發布了您不打算公開的內容。
  • 想要重新命名套件。(重新命名套件的唯一方法是使用新名稱重新發布它)

注意: package-name@version 是唯一的,無法透過取消發布和重新發布來重複使用。我們建議您發布次要版本更新。

何時不建議使用

如果您不再有興趣維護套件,但希望使用者仍可安裝它,或您的套件有依賴項,我們建議您標示為已棄用。若要了解如何標示套件為已棄用,請參閱「標示套件或套件版本為已棄用和取消標示」。