Mole新手入门：mo clean深度清理缓存、日志与应用残留完全指南
【免费下载链接】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 是一款免费开源的 Mac 清理与系统优化工具，其核心命令mo clean可以深度清理 macOS 系统缓存、应用日志和已卸载应用的残留文件，一条命令就能帮你的 Mac 释放数 GB 磁盘空间。本文将带你完成从安装、预览到实际清理的全流程，即使是新手也能安全上手。
💾为什么需要 mo clean？用久了的 Mac 会悄悄积攒大量缓存、日志和无主残留文件，占用空间还拖慢系统。手动翻找 Library 目录既低效又容易误删，而 Mole 的mo clean只清理经过验证的安全目标，让你放心又省力。
一键安装 Mole：两条命令搞定
Mole 是 macOS 专用的命令行（CLI）工具，推荐通过 Homebrew 安装：
brew install mole如果你的 macOS 版本已不被 Homebrew 支持，可以克隆仓库后运行安装脚本 install.sh：
git clone https://gitcode.com/GitHub_Trending/mole15/Mole cd Mole && ./install.sh安装完成后，命令名为mo。先运行mo --version确认安装成功。
新手第一步：用 dry-run 预览 mo clean 会清理什么
删除类操作前，强烈建议先用预览模式看看 Mole 打算清理哪些路径（预览不会修改任何文件）：
mo clean --dry-run输出会按分类列出可清理项目、数量和大小，例如：
➤ User essentials ✓ User app cache · 18 items, 2.4GB ✓ User app logs · 7 items, 12.8MB ➤ Browsers ✓ Safari cache · 24 items, 642.1MB ✓ Chrome cache · 31 items, 1.2GB如果想看更详细的执行日志，可以加上--debug参数：
mo clean --dry-run --debug✅ 看到"Potential reclaimable space: 120.96GB (no changes made)"这类提示，说明预览完成、未动任何文件。
mo clean 深度清理什么？五类目标一览
mo clean的清理范围由源码 lib/clean/user.sh、lib/clean/apps.sh、lib/clean/dev.sh 等模块定义，主要覆盖五大类：
| 分类 | 内容 |
|---|---|
| 用户基础项 | 用户应用缓存、应用日志、废纸篓 |
| 应用缓存 | App Store 缓存、各应用的本地缓存目录 |
| 浏览器缓存 | Safari、Chrome、Edge 等浏览器的缓存与旧版本 |
| 开发者工具 | npm、pnpm、Xcode 模拟器缓存、构建缓存等可重建产物 |
| 应用残留 | 已卸载应用留下的偏好设置、日志等"无主"文件 |
🛡️安全机制说明：Mole 在删除前会校验路径、保护系统目录与其他应用仍在使用的共享数据，拿不准的项目会跳过或拒绝删除。相关设计可阅读 docs/SECURITY_DESIGN.md 和 SECURITY.md，删除漏斗逻辑实现在 lib/core/file_ops.sh。
正式执行 mo clean 深度清理并看懂结果
预览满意后，去掉--dry-run正式执行：
mo clean部分系统级缓存需要管理员密码（sudo）才能清理，Mole 会适时提示输入；输入密码即可，输入密码不会被误判为"跳过"（这是 V1.42.0 修复过的细节）。
清理完成后的摘要长这样，重点关注三行：
- Tracked cleanup：本次实际清理的总大小
- Items cleaned / Categories：清理的项目数与分类数
- Free space (+x.xGB)：清理前后剩余空间的对比
👀 如果某项显示 "skipped (pnpm busy)"，说明对应应用正在占用它，Mole 会自动跳过而不是强行删除，下次清理时会再试。
保护不想删的目录：mo clean --whitelist
如果你某些缓存目录想永久保留，可以用白名单功能：
mo clean --whitelist在交互菜单中选中要保护的缓存后，配置会持久化保存在~/.config/mole/whitelist，之后每次mo clean都会自动跳过它们。白名单与卸载保护逻辑分别位于 lib/manage/whitelist.sh 和 lib/core/app_protection.sh。
清理后复查：mo history 与操作日志
Mole 会把每次清理活动写入日志~/Library/Logs/mole/operations.log，随时可以复查：
mo history # 查看清理历史 mo history --json # 以 JSON 输出，方便脚本处理历史功能源码见 lib/core/history.sh。若你不希望记录操作日志，可设置环境变量MO_NO_OPLOG=1。
新手常见问题 FAQ
1️⃣ mo clean 和 mo uninstall 有什么区别？mo uninstall用于卸载还在安装的应用（连同它的残留一起删掉）；应用已经手动删除后，用mo clean扫尾清理残留。
2️⃣ 会误删我的文档、照片吗？不会。Mole 只处理已知安全的缓存、日志与残留路径，无法证明安全的文件会被跳过或拒绝。
3️⃣ 清理能回退吗？用户级清理会尽量走废纸篓路由（见 lib/core/file_ops.sh），清理后可在废纸篓中找回。
4️⃣ 清理速度太慢怎么办？扫描受超时预算约束，超大目录会降级为部分结果而不是卡死（见 tests/clean_core.bats 覆盖的测试）。
进阶：Mole 的清理全家桶
熟悉mo clean后，可以试试其他命令组成"组合拳"：
mo analyze # 终端磁盘可视化探索，找出大文件 mo optimize # 刷新缓存与系统服务 mo purge # 清理 node_modules、target 等项目构建产物 mo installer # 找出 Downloads 里的 DMG/PKG 安装包 mo status # 实时查看 CPU、内存、磁盘健康面板写在最后
Mole 的核心价值就一句话：把危险的"翻 Library 目录"变成一条可预览、可回看、有日志的mo clean。建议养成习惯——每月运行一次mo clean --dry-run看看可释放空间，确认后正式执行，用mo history复查结果。更多功能详情见 README.md。
【免费下载链接】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），仅供参考
