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

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

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

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

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

開啟[深度清理](/tw/docs/features/deep-clean)，先執行掃描。如果專案放在其他磁碟，點選掃描按鈕旁的下拉箭頭，進入**選擇磁碟**，將對應磁碟加入掃描範圍。

![MangoDisk 在 macOS 的深度清理畫面，顯示清理類別、使用者快取明細與選取控制項](https://assets.mangodisk.app/images/screenshots/tw/light-01-deep-cleanup.jpg)

**專案相依套件清理會直接刪除所選內容，不會移至垃圾桶或資源回收筒。** 如果曾直接修改 `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 官方目錄說明](https://docs.npmjs.com/cli/v11/configuring-npm/folders/)。

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

如果想處理的是下載資料，可以另外查看 [npm 快取清理方法](/tw/blog/clean-npm-cache)。使用 pnpm 時，也應將[共用儲存空間的整理](/tw/blog/clear-pnpm-store-cache)與專案相依套件清理分開考慮。

## 之後還想執行專案，如何裝回套件？

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

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

```bash
npm ci
```

這會依鎖定檔重新安裝套件；如果還有 `node_modules`，會先將其移除。套件清單與鎖定檔不一致時，指令會回報錯誤，不要為了完成安裝就刪除鎖定檔。詳見 [npm ci 官方說明](https://docs.npmjs.com/cli/v11/commands/npm-ci/)。

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

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

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

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

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

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