目錄

npm-cache

操作套件快取

選擇 CLI 版本

目錄

概要

npm cache add <package-spec>
npm cache clean [<key>]
npm cache ls [<name>@<version>]
npm cache verify

注意：此指令不了解工作區。

說明

用於新增、列出或清除 npm 快取資料夾。

  • add：將指定的套件新增到本機快取。此指令主要供 npm 內部使用，但它可以提供一種方式來明確地將資料新增到本機安裝快取。

  • clean：刪除快取資料夾中的所有資料。請注意，這通常是不必要的，因為 npm 的快取具有自我修復功能，並且不易發生資料損毀問題。

  • verify：驗證快取資料夾的內容，收集任何不需要的資料，並驗證快取索引和所有快取資料的完整性。

詳細資料

npm 將快取資料儲存在已設定 cache 中的不透明目錄中，稱為 _cacache。此目錄是一個 cacache 基於內容可尋址的快取，儲存所有 http 要求資料以及其他與套件相關的資料。此目錄主要透過 pacote 存取，這是從 npm@5 開始負責所有套件擷取的函式庫。

通過快取的所有資料在插入和提取時都會經過完整驗證。快取損毀會觸發錯誤或發出訊號給 pacote，表示必須重新擷取資料，而它會自動執行此動作。因此，除了回收磁碟空間之外，不應有任何其他原因需要清除快取，這就是 clean 現在需要 --force 才能執行的緣故。

目前沒有透過 npm 公開的方法來檢查或直接管理此快取的內容。若要存取它，必須直接使用 cacache。

npm 本身不會移除資料：快取會隨著安裝新套件而擴充。

關於快取設計的說明

npm 快取嚴格來說是一個快取：不應依賴它作為套件資料的持久且可靠資料儲存。npm 不保證先前快取的資料片段稍後仍會可用，而且會自動刪除損毀的內容。快取做出的主要保證是，如果它確實傳回資料，該資料將與插入的資料完全相同。

若要執行現有快取內容的離線驗證，請使用 npm cache verify。

設定

快取

  • 預設值：Windows：%LocalAppData%\npm-cache，Posix：~/.npm
  • 類型：路徑

npm 快取目錄的位置。

另請參閱

在 GitHub 上編輯此頁面
1 貢獻者lukekarrys
上次由 lukekarrys 於 2023 年 1 月 1 日 編輯