MangoDisk 標誌

目前的瀏覽器版本過舊

MangoDisk 網站需要較新的瀏覽器才能正確顯示。請升級 Microsoft Edge,或使用其他現代瀏覽器開啟。

你仍然可以直接下載 MangoDisk:

升級 Microsoft Edge

如何清理舊專案的 node_modules,釋放磁碟空間

舊專案的 node_modules 佔用太多空間?用 MangoDisk 集中查看相依套件資料夾的路徑與大小,保留原始碼和鎖定檔,再移除暫時不需要、之後能重新安裝的套件。

發布於 2026/11/16作者: Harry

以前做的網站、練習用的範例專案,即使已經沒在使用,裡面的 node_modules 還是會佔用空間。確認專案暫時用不到,而且之後能重新安裝套件,就可以刪除這部分相依套件資料夾,保留原始碼。 下次要執行專案時,需要先把套件裝回來。

MangoDisk 支援掃描專案的相依套件與建置產物,將找到的路徑和大小集中列出。你可以確認各個資料夾屬於哪個專案,再決定要移除哪些,不必逐一打開舊專案查看大小。

用 MangoDisk 找出舊專案的相依套件

開啟深度清理,先執行掃描。如果專案放在其他磁碟,點選掃描按鈕旁的下拉箭頭,進入選擇磁碟,將對應磁碟加入掃描範圍。

MangoDisk 在 macOS 的深度清理畫面,顯示清理類別、使用者快取明細與選取控制項

專案相依套件清理會直接刪除所選內容,不會移至垃圾桶或資源回收筒。 如果曾直接修改 node_modules 裡的檔案,請先備份這些變更;重新安裝套件不會還原手動修改的內容。

掃描完成後,依序檢查:

  1. 在底部的選擇方式選單中選擇全部取消選取,先清除目前的勾選,方便只處理這次要整理的內容。
  2. 找到專案建置產物,展開 Node.js 建置產物。
  3. 比較明細中的路徑和大小,找出暫時不使用的專案。名稱相近時,開啟所在資料夾確認,不要只憑名稱或大小決定。
  4. 只勾選確認要移除的 node_modules 資料夾,保留還在使用的專案。同一類別也可能列出框架建置快取,不必整組全部選取。
  5. 停止相關專案的開發伺服器、建置及套件安裝作業,確認所選路徑與預估可釋放的空間,再點選清理並確認。

MangoDisk 幫你找出分散的相依套件資料夾,方便比較與選擇。哪些專案可以暫時收起來,仍由你決定;資料夾很大,不代表它已經沒用。

哪些專案適合先清理?

可以先從已經告一段落、只想保留原始碼的專案開始,例如做完的教學範例、不再維護的舊網站,或試過之後擱置的原型。

正在開發、近期需要展示,或接下來要離線使用的專案,可以先保留。刪除相依套件後,通常需要重新安裝才能執行或建置,反而可能打斷接下來的工作。

清理前,確認以下內容都留在專案裡:

  • 原始碼與素材:自己寫的程式碼、網頁、圖片及其他專案檔案。
  • 套件清單與鎖定檔:package.json,以及專案使用的 package-lock.json、pnpm-lock.yaml 或 yarn.lock。
  • 執行設定與本機資料:例如 .env、本機資料庫,以及尚未備份的上傳檔案。

如果套件來自私人套件庫、公司內部來源,或專案使用較舊的執行環境,先確認之後仍能安裝。不確定的專案就先留著,不必一次全部清完。

刪除 node_modules,也會清掉 npm 快取嗎?

這是兩種不同的清理。node_modules 放的是專案已安裝的相依套件;npm 下載快取則保留可重複使用的套件資料,兩者通常存放在不同位置。可參考 npm 官方目錄說明。

因此,清除 npm 快取後,舊專案的相依套件資料夾仍可能佔用空間;只刪除某個專案的 node_modules,也不會順便清空 npm 下載快取。

如果想處理的是下載資料,可以另外查看 npm 快取清理方法。使用 pnpm 時,也應將共用儲存空間的整理與專案相依套件清理分開考慮。

之後還想執行專案,如何裝回套件?

回到專案根目錄,也就是放著 package.json 的位置,按照專案原本的安裝說明恢復相依套件。

使用 npm 且保留相符 package-lock.json 的專案,通常可以執行:

npm ci

這會依鎖定檔重新安裝套件;如果還有 node_modules,會先將其移除。套件清單與鎖定檔不一致時,指令會回報錯誤,不要為了完成安裝就刪除鎖定檔。詳見 npm ci 官方說明。

原本使用 pnpm 或 Yarn 的專案,請繼續使用原來的工具與安裝說明,避免任意改用 npm,產生另一套鎖定檔。安裝過程可能需要下載套件及編譯元件,完成後再嘗試啟動專案。

如果安裝失敗,先確認專案要求的 Node.js 版本、套件來源及帳號權限。清理相依套件不會補齊這些執行條件,也不保證所有舊專案都能立即恢復運作。

清理後,確認磁碟空間是否增加

完成後先查看 MangoDisk 的清理結果與磁碟可用空間。若部分資料夾未能處理,依結果提示確認原因;仍在使用的專案先停止執行,確認後再試。

如果相依套件資料夾已經清掉,磁碟卻還是很滿,可以用磁碟空間分析查看專案裡還有什麼佔用空間,例如影片素材、資料集或匯出的檔案。這些內容需要分別判斷,不能把整個專案資料夾當成相依套件一起刪除。

下載 MangoDisk,先掃描看看舊專案留下了多少相依套件。保留之後可能繼續使用的程式碼,按需清理暫時用不到、可以重新安裝的部分。其他相關整理方式可見開發者清理指南。