mac-cleaner-cli：用一條 npx 指令清理 macOS 磁碟空間
免費 macOS CLI 用於清理磁碟空間、快取、日誌、Homebrew、Xcode。 CleanMyMac 的開源替代品。
秒懂
- 它是什麼？
- 在終端機中刪除快取、日誌、Homebrew 殘留和 Xcode DerivedData 來釋放磁碟空間。
- 適合誰用？
- mac-cleaner-cli 提供了一種互動式且可腳本化的方式來回收 macOS 磁碟空間，但 README 本身警告刪除檔案存在風險，因此備份至關重要。 先執行 `npx mac-cleaner-cli scan --json --verbose` 觀察路徑，再用 `clean --categories ... --dry-run` 確認範圍；`--risky`、`--unsafe` 涉及 Downloads、備份與大檔案，不能和一般快取清理混用。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 29 天前。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
mac-cleaner-cli｜掃描、選擇並從終端清理
mac-cleaner-cli 是一個用 TypeScript 編寫的 macOS 命令列工具，它掃描機器上可刪除的檔案以釋放磁碟空間。根據 README，該工具涵蓋快取、日誌、Homebrew 殘留、Xcode DerivedData 和垃圾檔案。快速入門是一條指令：npx mac-cleaner-cli。該指令執行一個互動式會話，首先掃描可清理檔案，然後顯示找到的內容及大小，讓使用者精確選擇要清理的內容，最後只刪除所選項目。README 強調使用此 npx 呼叫無需安裝。該工具被描述為免費且開源，並定位為 CleanMyMac 等付費清理工具的替代品。
第1項專案核對：mac-cleaner-cli 的檢查不能只看功能名稱。使用者應確認作業系統、執行時版本、輸入格式和權限邊界，再依 README 入口建立最小案例。對 guhcostan/mac-cleaner-cli 而言，先執行 `npx mac-cleaner-cli scan --json --verbose` 觀察路徑，再用 `clean --categories ... --dry-run` 確認範圍；`--risky`、`--unsafe` 涉及 Downloads、備份與大檔案，不能和一般快取清理混用。 先觀察命令是否接受輸入，再檢查輸出檔案、終端訊息、服務狀態或備份內容是否符合文件描述。若結果不同，保留完整錯誤、版本與設定，不把一次成功寫成相容性承諾。實際採用還要看失敗後如何恢復，README 沒有提供的行為應標成未知，交由原始碼、issue 或發布記錄補查。
第2項專案核對：mac-cleaner-cli 的檢查不能只看功能名稱。使用者應確認作業系統、執行時版本、輸入格式和權限邊界，再依 README 入口建立最小案例。對 guhcostan/mac-cleaner-cli 而言，先執行 `npx mac-cleaner-cli scan --json --verbose` 觀察路徑，再用 `clean --categories ... --dry-run` 確認範圍；`--risky`、`--unsafe` 涉及 Downloads、備份與大檔案，不能和一般快取清理混用。 先觀察命令是否接受輸入，再檢查輸出檔案、終端訊息、服務狀態或備份內容是否符合文件描述。若結果不同，保留完整錯誤、版本與設定，不把一次成功寫成相容性承諾。實際採用還要看失敗後如何恢復，README 沒有提供的行為應標成未知，交由原始碼、issue 或發布記錄補查。
第3項專案核對：mac-cleaner-cli 的檢查不能只看功能名稱。使用者應確認作業系統、執行時版本、輸入格式和權限邊界，再依 README 入口建立最小案例。對 guhcostan/mac-cleaner-cli 而言，先執行 `npx mac-cleaner-cli scan --json --verbose` 觀察路徑，再用 `clean --categories ... --dry-run` 確認範圍；`--risky`、`--unsafe` 涉及 Downloads、備份與大檔案，不能和一般快取清理混用。 先觀察命令是否接受輸入，再檢查輸出檔案、終端訊息、服務狀態或備份內容是否符合文件描述。若結果不同，保留完整錯誤、版本與設定，不把一次成功寫成相容性承諾。實際採用還要看失敗後如何恢復，README 沒有提供的行為應標成未知，交由原始碼、issue 或發布記錄補查。
第4項專案核對：mac-cleaner-cli 的檢查不能只看功能名稱。使用者應確認作業系統、執行時版本、輸入格式和權限邊界，再依 README 入口建立最小案例。對 guhcostan/mac-cleaner-cli 而言，先執行 `npx mac-cleaner-cli scan --json --verbose` 觀察路徑，再用 `clean --categories ... --dry-run` 確認範圍；`--risky`、`--unsafe` 涉及 Downloads、備份與大檔案，不能和一般快取清理混用。 先觀察命令是否接受輸入，再檢查輸出檔案、終端訊息、服務狀態或備份內容是否符合文件描述。若結果不同，保留完整錯誤、版本與設定，不把一次成功寫成相容性承諾。實際採用還要看失敗後如何恢復，README 沒有提供的行為應標成未知，交由原始碼、issue 或發布記錄補查。
第5項專案核對：mac-cleaner-cli 的檢查不能只看功能名稱。使用者應確認作業系統、執行時版本、輸入格式和權限邊界，再依 README 入口建立最小案例。對 guhcostan/mac-cleaner-cli 而言，先執行 `npx mac-cleaner-cli scan --json --verbose` 觀察路徑，再用 `clean --categories ... --dry-run` 確認範圍；`--risky`、`--unsafe` 涉及 Downloads、備份與大檔案，不能和一般快取清理混用。 先觀察命令是否接受輸入，再檢查輸出檔案、終端訊息、服務狀態或備份內容是否符合文件描述。若結果不同，保留完整錯誤、版本與設定，不把一次成功寫成相容性承諾。實際採用還要看失敗後如何恢復，README 沒有提供的行為應標成未知，交由原始碼、issue 或發布記錄補查。
mac-cleaner-cli｜掃描器發現的內容：安全、中度和風險類別
README 將可清理項目分為三個安全級別。綠色的「安全」類別包括廢紙簍、/tmp 和 /var/folders 中的暫存檔案、Chrome、Safari、Firefox 和 Arc 的瀏覽器快取、Homebrew 下載快取以及未使用的 Docker 映像、容器和卷。黃色的「中度」類別涵蓋 ~/Library/Caches 中的系統快取、系統和應用程式日誌、開發快取（如 npm、yarn、pip、Xcode DerivedData 和 CocoaPods）以及舊專案中孤立的 node_modules。紅色的「風險」類別包括超過 30 天的下載、iOS 備份、電子郵件附件、重複檔案、大於 500MB 的檔案、未使用的語言本地化檔案和過時的 git worktrees。除非使用者傳遞 --risky 旗標，否則風險項目會被隱藏。該工具還支援在互動模式下使用方向鍵深入類別以選擇特定資料夾或檔案。
mac-cleaner-cli｜使用 scan、clean 和 maintenance 指令實現自動化
為了腳本化或用於 cron 或 CI，mac-cleaner-cli 提供非互動式指令。README 記錄了 npx mac-cleaner-cli scan 來預覽可以清理的內容而不刪除任何東西，--json 旗標用於機器可讀輸出，--verbose 用於包含項目路徑。clean 指令接受 --categories 加逗號分隔的清單，--yes 跳過提示，--dry-run 預覽，--all 清理所有安全的內容。除非傳遞 --unsafe，否則風險類別始終被跳過。維護任務是單獨的：npx mac-cleaner-cli maintenance --dns 刷新 DNS 快取，--purgeable 釋放可清除空間；README 指出 DNS 刷新可能需要 sudo。其他指令包括 categories 列出所有可用類別，config 管理設定，backup 列出或清理備份。
mac-cleaner-cli｜全域安裝或從原始碼執行
主要用法是透過 npx，它會下載並執行套件，無需持久安裝。對於頻繁使用，README 建議使用 npm install -g mac-cleaner-cli 進行全域安裝，之後可以直接使用 mac-cleaner-cli 指令。該倉庫還記錄了從原始碼開發：複製後，它使用 bun 進行依賴安裝和執行腳本，包括 bun run dev、test、lint 和 build。該專案用 TypeScript 編寫；README 徽章顯示 TypeScript 6.0，但該版本號應參照套件元資料。倉庫元資料列出該專案為 TypeScript，目前有 1902 個星標和 173 個複刻。
mac-cleaner-cli｜README 中的安全和隱私聲明
README 做出了幾項安全和隱私聲明。它聲稱該工具 100% 離線執行，無網路存取，不發送遙測，並且不需要 root 權限。它還聲稱依賴極少：五個執行時依賴，來自受信任的維護者。該專案是開源的，README 說每次發布都用 TypeScript、ESLint 和自動化測試進行測試，並且依賴透過 Socket.dev 監控供應鏈攻擊。漏洞報告被引導到 GitHub Security Advisories。這些是 README 的聲明，不是獨立驗證；本文沒有資料來證實它們。
mac-cleaner-cli｜授權條款和關於資料遺失的免責聲明
mac-cleaner-cli 在 MIT 授權條款下發布，如 README 和授權條款摘錄所述。MIT 授權條款授予使用、複製、修改、合併、發布、分發、再授權和出售軟體副本的權利，並「按現狀」提供軟體，不提供任何形式的保證。README 包含一條免責聲明，說明該工具會刪除檔案，使用者應確保對重要資料有備份。授權條款本身沒有說明該工具的安全狀況、支援或保證；這些由免責聲明和專案文件覆蓋。
專案化核對：先執行 `npx mac-cleaner-cli scan --json --verbose` 觀察路徑，再用 `clean --categories ... --dry-run` 確認範圍；`--risky`、`--unsafe` 涉及 Downloads、備份與大檔案，不能和一般快取清理混用。 這些觀察只針對 guhcostan/mac-cleaner-cli README 已列出的行為；素材沒有交代的版本、平台或安全結果，保留為待確認事項。
編輯結論
mac-cleaner-cli 提供了一種互動式且可腳本化的方式來回收 macOS 磁碟空間，但 README 本身警告刪除檔案存在風險，因此備份至關重要。 先執行 `npx mac-cleaner-cli scan --json --verbose` 觀察路徑，再用 `clean --categories ... --dry-run` 確認範圍；`--risky`、`--unsafe` 涉及 Downloads、備份與大檔案，不能和一般快取清理混用。
社群筆記