Mole 安装与上手指南：Mac 磁盘清理工具从装到用的完整路径

Mole 安装与上手指南：Mac 磁盘清理工具从装到用的完整路径

【免费下载链接】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

Mac 用久了，缓存、日志、装过又卸掉的应用残留会悄悄占掉几十 GB 空间。Mole 是一款开源的 Mac 终端磁盘清理工具，一个命令入口mo就集成了深度清理、应用卸载、磁盘分析、系统监控等能力，目标是把这些空间挖回来。这篇指南按"选安装方式 → 装 → 验证 → 日常用 → 出问题怎么办"的顺序走一遍，新手照着做即可。

Mole 怎么装最省心？

先想清楚你的 Mac 上有没有 Homebrew。如果已经装了 Homebrew 且它仍支持你当前的 macOS 版本，走 Homebrew 是最省心的：包管理器帮你处理依赖和路径，以后升级也只需一条命令。

brew install mole

如果你的 macOS 版本已经超出 Homebrew 支持范围，或者你就是想要更新的控制力，用官方安装脚本。脚本位于仓库根目录的 install.sh，它会自动识别 CPU 架构（Intel 或 Apple Silicon）、下载对应二进制、校验文件完整性并设置可执行权限：

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

两个细节值得知道。其一，脚本默认装到/usr/local/bin，首次安装可能要输管理员密码。不想每次都输密码的话，可以先建一个属于你自己用户的目录再装：

mkdir -p "$HOME/.local/bin" curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash -s -- --prefix "$HOME/.local/bin" export PATH="$HOME/.local/bin:$PATH"

记得把第二行的 PATH 导出写进~/.zshrc，新开的终端才会生效。Mole 更新时只更新你当初调用的那份安装，所以会一直待在这个目录里。

其二，想锁版本时，在脚本后面追加版本号（releases 页任意 tag，带不带V前缀都行）即可；追加main则安装开发分支的最新代码，注意那是不发布版，可能带毛刺。

装好后的更新很轻：Homebrew 用户执行brew upgrade mole，脚本安装用户直接mo update。

装完怎么确认 Mole 成功了？

三条命令就能确认安装可用：

mo --version # 看装上的版本 mo completion # 配置 shell 的 Tab 补全 which mo # 确认它在 PATH 里

顺手再跑一下mo touchid，把 Touch ID 接入 sudo，之后需要管理员权限的操作就不用反复敲密码了。如果which mo找不到命令，多半是 PATH 没包含安装目录，把上面--prefix那段里提到的目录加进 PATH 即可。

第一次清理前，先学会"只看不动"

Mole 会删文件，所以它把"预览"做成了正式能力：所有危险操作都支持--dry-run，只列出将处理的路径，不落盘。

mo clean --dry-run # 预览系统清理会动什么 mo uninstall --dry-run # 预览某个应用会被连带清掉哪些残留

看完预览觉得没问题，去掉--dry-run再执行。另外，如果你某些缓存不想被碰（比如某个大项目依赖的缓存），用mo clean --whitelist把对应项加入保护名单，选择会持久保存在~/.config/mole/whitelist；优化类的保护项则用mo optimize --whitelist管理。

Mole 日常怎么用？

装好之后的使用围绕mo后面跟一个动词展开。不跟参数直接跑mo，会进入交互式菜单，逐项选；习惯敲命令的话，下面是几个最常用的入口，值得记下来：

• mo clean：清理已知安全的缓存、日志、临时文件和开发者产物，同时扫已卸载应用的残留。这是日常的主力。
• mo uninstall：卸载应用并清掉能确认归属于它的相关文件；共享数据有其他应用还在用时会保留。
• mo optimize：刷新 Finder、网络、数据库等系统服务，做有边界维护，不合适的项会跳过并说明原因。
• mo analyze：打开终端版磁盘浏览器，支持方向键/Vim 键位、过滤、多选，选中的项目经确认后会移入废纸篓。默认概览不含外接盘，想看就mo analyze /Volumes。
• mo status：只读的系统健康面板，CPU、内存、磁盘、网络、电源一屏看全。
• mo purge：清理项目里的构建产物（如node_modules、target、dist），只永久删除你确认的项。

一个新手习惯建议：每周跑一次mo clean，每月mo analyze翻一遍大目录，mo status卡顿时看一眼。动作之前先--dry-run，成本很低，能避免大部分意外。

出问题或想排查时，先查这三处

想看 Mole 到底动过什么：所有清理活动会记入~/Library/Logs/mole/operations.log，用mo history直接回看（加--json可导出）。不想记录的话，设环境变量MO_NO_OPLOG=1关闭。

想看更详细的运行过程：命令后加--debug，比如mo clean --dry-run --debug，预览和详细日志一起出。

想彻底移除 Mole：直接mo remove，它会把安装从系统里清掉。

更细的安全边界——哪些路径绝不碰、共享目录如何保护、当前的已知限制——可以看仓库里的 SECURITY.md 和 安全设计说明，对生产环境评估尤其值得读。

下一步

装好后别急着跑mo clean正式清理，先用--dry-run把预览跑一遍，确认它列出的都是可再生成或确属残留的东西。习惯之后再考虑mo completion补全和 Quick Launchers（仓库scripts/下提供 Raycast/Alfred 的快捷启动配置脚本），把常用入口接到日常手势里。

【免费下载链接】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