Mole：Mac 清理与磁盘分析 CLI 指南，先 dry-run 再释放几十 GB 空间
【免费下载链接】Mole🐹 Clean, uninstall, analyze, optimize, and monitor your Mac. Free open-source CLI, plus a native Mac app.项目地址: https://gitcode.com/GitHub_Trending/mole15/Mole
Mole 是面向 macOS 12+ 的开源命令行清理工具（GPL-3.0），mo一条命令覆盖缓存清理、应用残留卸载、磁盘空间分析与实时状态监控，适合想腾磁盘空间、又不想装图形维护软件的 Mac 用户。
磁盘告急时，手动排查为什么不现实
可用空间紧张时，第一反应往往是du翻目录，但扫完 Home 要几分钟，翻到 Library 深处时已经忘了自己在找什么。更隐蔽的是残留：应用拖进废纸篓后，~/Library里的偏好设置、缓存和登录项还在，占着空间却没有任何入口能找到。Mole 把这类操作压成几个动词：clean清缓存与残留，uninstall连同本体一起移除应用，analyze下钻找空间大户，purge只删可重建的构建产物。
装好并跑通第一次：预览参数先行
Homebrew 一条命令安装：
brew install mole首次运行建议先跑mo clean --dry-run：它列出候选路径、大小和分类，但不动任何文件，确认清单符合预期后再执行真实清理。mo uninstall、mo optimize、mo purge、mo installer都支持同一个--dry-run参数。每次真实操作会记入~/Library/Logs/mole/operations.log，事后用mo history回看，删了什么、删错想追回，都有据可查。
mo clean --dry-run # 只预览候选项，不改动文件 mo clean # 确认后执行真实清理💾 功能逐条拆解
缓存清理：mo clean 与 mo installer
日常积累的用户缓存、浏览器缓存、npm/pnpm 缓存和废纸篓归mo clean管；mo installer专找 Downloads、Homebrew 缓存、iCloud、邮件等位置里的 DMG、PKG、ISO 安装包。两者都是先列清单、确认后再动。mo clean --whitelist可以把不想碰的缓存加进白名单，选择持久化在~/.config/mole/whitelist。跑完看到逐条打勾的类别统计和总释放量，README 示例中一次 clean 释放 4.5GB、97 个条目。
应用残留卸载：mo uninstall
要彻底移除一个应用时用：它列出已装应用及大小、最近使用时间，选中后展示移除清单，包含本体和能归因到该应用的 Application Support、Preferences；其他应用仍在使用的共享数据会被保留。若本体已删、只剩数据，改用mo clean扫残留。README 示例中移除 Photoshop 2024 共释放 12.80GB，其中应用本体只有 4.2GB——多出来的部分就是平时手动清不到的残留。
磁盘空间分析：mo analyze
空间去向不明时用：mo analyze打开终端磁盘浏览器，首屏按大小列出顶层目录与占比条，支持方向键/Vim 键位下钻、过滤、多选，选中项确认后才移入废纸篓。也可以指定路径缩小范围：mo analyze /Volumes只看外置磁盘，mo analyze /private/tmp复查用户临时文件；mo analyze --json ~/Documents输出一份一次性 JSON 报告，结果带scan_status字段，脚本可以据此判断扫描是否完整。
构建产物清理：mo purge
项目里堆积node_modules、target、build、dist时用。它按项目分组候选，近 7 天有文件活动或活动状态无法确认的目录默认不选，包含部署密钥对、嵌套 Git 仓库或 Git 跟踪文件的目录直接保护；确认项永久删除而不进废纸篓。非交互脚本调用必须显式加--yes，先用mo purge --dry-run审查更稳妥。示例中选中两个项目产物后，结束行显示释放 6.00GB。
边界与红线
- Mole 面向 macOS 12 及以上，Intel 与 Apple Silicon 均支持；Windows 仅有实验分支，Linux 无官方版本。
- 以普通用户运行，不要 sudo 启动；涉及系统级文件时 Mole 会自行请求管理员权限，root 下直接运行会被拒绝。
mo purge对确认项是永久删除，务必先--dry-run审查；其余删除类操作默认走废纸篓。- 所有删除调用汇入同一路径校验：拒绝空路径与相对路径、解析符号链接、对
/System、/Library/Apple、com.apple.*等受保护路径复检，无法证明安全就跳过或拒绝，而不是"看起来像缓存就删"。 mo analyze默认概览不含外置磁盘，需要时显式指定mo analyze /Volumes；扫描大目录耗时较长，尽量指定具体路径。
深入阅读
- docs/SECURITY_DESIGN.md：威胁模型、路径校验与应用保护机制的完整说明，想弄清"如何不误删"先读它。
- lib/core/file_ops.sh：删除漏斗的核心实现，所有删除调用在这里汇入统一的路径校验。
- tests/：覆盖清理、卸载、purge 全流程的 Bats 回归测试套件，是行为边界的第一手依据。
现在就能跑的最小动作：brew install mole之后先执行mo clean --dry-run，看看你的机器上有多少可回收空间。
【免费下载链接】Mole🐹 Clean, uninstall, analyze, optimize, and monitor your Mac. Free open-source CLI, plus a native Mac app.项目地址: https://gitcode.com/GitHub_Trending/mole15/Mole
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
