開發者磁碟清理
npm 快取怎麼清?會刪掉專案的相依套件嗎?
npm 快取占用太多空間?用 MangoDisk 查看大小並清理下載快取,或使用 npm 指令處理。一次分清快取與 node_modules,不必刪除原始碼或重裝相依套件。

專案早就沒在用了,當初安裝套件留下的 npm 快取卻可能還在占空間。它通常放在使用者目錄裡,不一定會隨著專案資料夾一起刪除。
npm 下載快取可以清理,它和專案裡的 node_modules 是兩回事。 在正常的快取設定下,清理下載快取不會移除已安裝的相依套件,也不必重裝 Node.js;只是日後安裝套件時,可能需要重新下載。
不想翻隱藏資料夾,可以用 MangoDisk 一起找出 npm 和其他支援的開發工具快取,直接比較大小。先看哪一項值得清,就不用對著陌生的資料夾猜用途。
先看看 npm 快取占了多少空間
開啟深度清理,執行掃描,找到 npm 快取項目。展開結果,就能查看路徑、容量和清理說明,不必自己逐一找資料夾。

這次若只想清 npm,先取消其他項目的勾選,再選取要清理的 npm 快取。等套件安裝和相關工作結束,確認路徑及預計釋放的空間後,再執行清理。單純掃描不會刪除檔案。
MangoDisk 的內建規則涵蓋 Windows 常見的 npm 快取位置,以及 macOS 的 ~/.npm/_cacache。如果你改過快取位置,請先用下文的指令確認實際路徑,別把「沒掃到」當成「沒有快取」。
npm 快取和 node_modules 差在哪?
快取保留下載過的套件資料,方便之後重複使用;node_modules 則是專案實際使用的相依套件。npm 官方目錄說明也將兩者分開存放。
| 內容 | 用途 | 清理 npm 下載快取時會怎樣 |
|---|---|---|
| npm 下載快取 | 安裝時可以重複使用的資料 | 刪除快取,之後可能需要重新下載 |
專案的 node_modules | 執行或建置專案所需的套件 | 不會因此被移除 |
| 全域安裝的命令列工具 | 透過 npm install -g 安裝的軟體 | 不會因此被移除 |
原始碼、package.json、package-lock.json | 程式碼、相依套件設定與版本紀錄 | 不是快取清理對象,應保留 |
這裡指的是快取與專案正常分開存放的情況。如果曾把快取路徑設到混放個人檔案的資料夾,請先調整設定,不要直接清空。
也別為了清快取,順手刪掉 package-lock.json。它記錄確切的相依套件版本,刪掉後,下次安裝取得的版本可能改變。
用指令清理 npm 快取
Windows 開啟 PowerShell,macOS 開啟「終端機」,先查目前的快取位置:
npm config get cache
這個指令只會讀取設定,不會刪除檔案。預設通常是 Windows 的 %LocalAppData%\npm-cache,或 macOS 的 ~/.npm。把顯示的路徑放到檔案總管或 Finder 開啟,就能查看資料夾大小。
想先檢查快取,並回收其中不再需要的資料,可以執行:
npm cache verify
verify 不只是檢查,也會整理無用的快取資料;它不是強制清空快取的指令。
確定需要騰出這部分空間,而且之後能重新下載套件,再等進行中的套件安裝和相關工作結束,執行:
npm cache clean --force
這會刪除 npm 下載快取,不會移到資源回收筒或垃圾桶。npm 要求加上 --force,是因為快取通常能自行處理完整性問題,不需要頻繁清空。詳細行為可參考 npm cache 官方文件。
清完之後,下次安裝可能變慢,而不是變快。如果接下來要離線工作,或目前無法重新下載私有套件,就先保留快取。快取不能當備份,但也沒必要為了例行清理而刪掉還用得上的資料。
空間還是不夠?看看舊專案占了多少
下載快取清掉後,各個專案的 node_modules 還在。因此,就算清理成功,也不一定能騰出很多空間。
這時可以切換到 MangoDisk 的磁碟空間分析,選擇存放專案的磁碟或資料夾。矩形圖的方塊越大,占用就越多;點進去能繼續比較裡面的資料夾,不用逐個專案開啟內容視窗查大小。

如果占用最多的確實是暫時不用的相依套件,可以回到深度清理,檢查支援清理的專案建置產物。刪除專案相依套件和清 npm 下載快取,是兩種不同的操作。 前者清掉後,再執行專案就需要重新安裝;原始碼、鎖定檔,以及自己改過的套件內容要先保留好。近期還在用的專案,不必為了騰空間反覆重裝。
資料夾很大,不代表就可以刪除。在磁碟空間分析中手動刪除會永久移除檔案,不經過資源回收筒或垃圾桶。不確定用途的先保留,詳見安全清理指南。
把各種快取放在一起比較
只清一份 npm 快取,用指令就能完成。想順便看看其他工具、舊專案留下多少檔案,MangoDisk 會更方便:在同一個畫面比較大小,再挑出值得清理的項目。
下載 MangoDisk,先掃描看看。免費開源,支援 Windows 和 macOS,不必註冊或登入;本文的掃描與清理都在本機完成,不需要啟用 AI。