網站導覽
目錄
npm-unpublish
選擇 CLI 版本
概要
npm unpublish [<package-spec>]
如需瞭解有關 npm 登錄檔如何處理取消發佈的詳細資訊,請參閱我們的 取消發佈政策。
警告
如果您的目的是鼓勵使用者升級,或您不再想維護套件,請考慮改用 deprecate
指令。
說明
這會從登錄檔中移除套件版本,刪除其項目並移除 tarball。
如果您未 登入,npm 登錄檔將傳回錯誤。
如果您完全未指定套件名稱,將從目前目錄中的專案擷取要取消發佈的名稱和版本。
如果您指定套件名稱但未指定版本,或如果您移除所有套件版本,登錄檔將完全移除根套件項目。
即使您取消發佈套件版本,該特定名稱和版本組合也永遠無法重複使用。若要再次發佈套件,您必須使用新的版本號碼。如果您取消發佈整個套件,您可能在 24 小時過後才能發佈該套件的任何新版本。
組態
dry-run
- 預設值:false
- 類型:布林值
表示您不希望 npm 進行任何變更,且它應該只報告它會執行的動作。這可以傳遞給任何修改您當地安裝的指令,例如 install
、update
、dedupe
、uninstall
,以及 pack
和 publish
。
注意:這不會受到其他與網路相關指令的尊重,例如 dist-tags
、owner
等。
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
設定中指定一個或多個工作空間。
此值不會匯出至子程序的環境。