如何在 Mac 安全刪除 node_modules，又不弄丟專案

先分清可重建的依賴與專案原始檔

node_modules 是專案已安裝的依賴樹，通常能從 package.json、正確的 lockfile、工作區設定與仍可取得的套件重建；原始碼、Git 歷史、設定、修補檔與 package.json 都不是快取，絕不能一起刪。npm 的共用下載快取預設在 ~/.npm，與 <project>/node_modules 的位置、影響範圍和復原成本都不同，不要在同一次清理中混在一起處理。

刪除前，確認專案真的能重建

先確認套件管理器與版本、套件資訊清單（manifest）、lockfile、私有套件庫權限、Git 與 file: 依賴、本機工作區、外部下載和原生編譯工具都可用。npm v12 已不再讀取 npm-shrinkwrap.json，舊專案必須先把這個格式相同的檔案重新命名為 package-lock.json。pnpm 使用 pnpm-lock.yaml，Yarn 使用 yarn.lock，Bun 新版使用 bun.lock、舊專案可能是 bun.lockb；只存在 node_modules 裡的手動修改，也必須先移到受版本控制的修補檔或 fork。monorepo 要當成同一套依賴系統處理：根目錄的 node_modules 可能供所有工作區共用，刪掉它會讓每個工作區一起停擺，重新安裝通常也要從管理整個安裝的根目錄執行。

1. 在專案根目錄執行 pwd；確認 package.json、正確的 lockfile 與工作區設定都存在，再用 git status 檢查並備份尚未提交的原始碼或設定。
2. 讀取 package.json 的 packageManager 欄位，確認對應的版本可用；並驗證私有套件庫、Git、file:、本機工作區、外部下載和原生工具鏈仍可存取。
3. 執行 du -sh ./node_modules 測量單一專案；要盤點已知的開發目錄時，可以用 find "$HOME/Projects" -type d -name node_modules -prune -exec du -sh {} +，但要把 $HOME/Projects 換成你核對過的實際根目錄。
4. 停止開發伺服器、測試監看程序、正在安裝套件的編輯器與套件管理器，只把選定的 node_modules 移到垃圾桶。
5. 從正確的儲存庫根目錄，用不會改寫 lockfile 的對應指令重新安裝；建置、測試與啟動都驗證通過後，再清空垃圾桶。

lockfile 不是套件備份；如果指定版本的依賴已經無法下載、私有服務無法使用，或某些修改只存在 node_modules 裡，刪除後可能暫時無法重建專案。

只移除一個核對過的依賴資料夾

先在正確的專案根目錄測量，再把該專案的 node_modules 移到垃圾桶，絕不能誤選上一層的儲存庫。在「終端機」執行 rm -rf ./node_modules 雖然比較快，卻會繞過垃圾桶、無法復原，只能在用 pwd 與專案檔案再次核對位置後使用；也不要把未經檢查的 find 輸出、萬用字元、空變數，或從不受信任來源複製的路徑接到刪除指令上。依專案使用的套件管理器重新安裝：npm 用 npm ci，pnpm 用 pnpm install --frozen-lockfile，新版 Yarn 用 yarn install --immutable（Yarn Classic 用 yarn install --frozen-lockfile），Bun 用 bun install --frozen-lockfile；不要為了清空間順手重寫 lockfile。

驗證重建結果與實際回收的空間

重新安裝成功，只代表套件能在目前的環境取得，還要執行專案文件指定的建置、測試、lint 與啟動流程；失敗時保留記錄，必要時先從垃圾桶還原，再檢查憑證、網路、Node 與套件管理器版本、原生工具鏈，以及 lockfile 是否一致。重新安裝會重新下載、建立連結、編譯原生模組並執行生命週期指令碼；省下多少空間，以 macOS 清理前後的實際可用空間為準。AskClean 只把辨識出的 node_modules 列為專案建置產物，原始碼與 .git 不會進入清單；你確認的資料夾會被永久刪除，不會移到垃圾桶。若想保留復原的機會，請自己在 Finder 把資料夾丟到垃圾桶，等重新安裝與建置都通過後再清空。

清理決策與風險對照

在 Mac 上刪除 node_modules 前，先找出最佔空間的專案，保護原始碼、package.json 與 lockfile，一次只移除一個專案的依賴，再用 npm、pnpm、Yarn 或 Bun 依 lockfile 重新安裝並驗證。

常見問題