如何防止重要项目被误删？CleanMyMac CLI ignore白名单使用教程

CleanMyMac CLI 是一款在终端中运行、面向开发者 Mac 的磁盘清理工具，能一键清理 Xcode、Docker、Homebrew 等开发缓存与项目构建产物，帮你快速找回宝贵的磁盘空间。但在清理的同时，新手最担心的问题是：会不会把我正在开发的重要项目删了？答案是：不会——只要用对 ignore 白名单。本教程将手把手教你在 3 步之内，为重要项目目录永久加锁，让它在所有扫描结果中"隐身"，从此清理缓存时彻底安心。

为什么 CleanMyMac CLI 需要 ignore 白名单？

CleanMyMac CLI 的清理能力覆盖两类场景：

其中purge会默认扫描~/Projects、~/Code、~/dev、~/GitHub、~/Workspace这几个常见开发目录。虽然工具内置了多重保护（详见 README.md 的 "Safety features" 部分）：

• 交互式预览：删除前必须先逐项确认，绝不"静默删除"
• 按年龄预选择：purge只对 7 天以上的产物预选，近期活跃的产物保持未选中
• 系统位置保护：受保护的系统路径自动排除在清理范围之外

但保险起见，对于绝对不能碰的目录（客户交付项目、实验性代码、备份副本），最稳妥的做法就是把它们加入 ignore 白名单——被忽略的路径会永久从clean、purge、analyze的所有扫描结果中消失，连"预览列表"里都看不到，从机制上杜绝误删。

3步配置 ignore 白名单保护重要项目

第 1 步：一键添加保护路径

在终端中执行ignore add命令，把你想要保护的项目目录加入白名单：

cleanmymac ignore add ~/Projects/important-project

💡 小贴士：路径支持~快捷写法。如果你的项目不在默认扫描目录里，也可以用cleanmymac purge ~/Work/client-project的方式指定扫描路径——此时同样建议先执行上面的添加命令，形成双重保险。

第 2 步：查看当前白名单列表

添加完成后，随时运行下面的命令检查所有受保护路径：

cleanmymac ignore list

输出会列出你加入的全部忽略路径，方便在团队协作或个人多项目管理时核对"哪些目录是上了保险的"。

第 3 步：解除保护（如不再需要）

当项目归档、迁移或完成交付后，可以把路径从白名单中移除，让它重新出现在扫描结果里：

cleanmymac ignore remove ~/Projects/important-project

⚠️ 注意：被忽略的路径会一直处于保护状态，直到你手动执行ignore remove。忘记这一点可能会让某些"想清理却扫不到"的产物困惑新人，建议在白名单较小时定期用ignore list复查。

常见使用场景：哪些路径最该加入白名单？

以下是新手最容易踩坑、建议优先保护的几类路径：

• 📦交付类项目：~/Projects/client-a-final——交付后还要保留构建产物的项目，产物本身就是交付物
• 🧪长期实验目录：里面放了你手动整理的旧版本依赖，删了找不回来
• 💾手动备份副本：比如~/backup-2024之类的快照目录，若恰好包含node_modules，默认purge扫描自定义路径时会把它列出来
• 🤖AI 工具工作区：clean ai会扫描 AI 工具残留，若你的 AI 实验数据放在标准项目目录下，加入白名单更稳妥

白名单之外的其他安全机制（一文看懂）

即使不加白名单，CleanMyMac CLI 的设计也处处体现"预览优先"原则：

1. 扫描 → 预览 → 确认三步流程：所有清理命令都是先扫描、分组展示结果（按项目或类别聚合），由你逐项勾选，最后明确确认后才执行删除
2. analyze只读浏览：cleanmymac analyze打开的交互式磁盘分析器只展示各目录占用，浏览行为本身不修改任何文件
3. ⚠️--force参数警示：--force会跳过交互确认、立即删除已检测到的条目。官方在 README.md 中明确建议：第一次运行任何清理命令时，务必先不带--force跑一遍，看清楚扫描结果后再决定是否使用
4. 安全承诺：工具的预览-删除行为、确认逻辑被官方列为安全敏感区域，具体政策可参考 SECURITY.md

安装与验证：快速上手 CleanMyMac CLI

如果你的 Mac 还没有安装，只需要一条 Homebrew 命令（需 macOS 11 及以上）：

brew install --cask macpaw/taps/cleanmymac-cli

安装完成后验证版本：

cleanmymac --version

输入cleanmymac即可进入交互式主菜单，其中Clean、Purge、Analyze、Optimize、Config五大入口清晰可见，ignore系列命令也在菜单中完整列出。

常见问题解答（FAQ）

Q1：加入白名单后，该路径里的垃圾文件就清理不了了吗？是的，被忽略的路径会完全不出现在clean、purge、analyze的扫描结果中。如果你只是想临时清理某个项目的node_modules，不必加入白名单，直接在预览界面取消勾选对应项目即可。

Q2：purge会删除我的源代码吗？不会。purge只识别并移除生成产物（如node_modules、.next、target、.venv、DerivedData、cmake-build-*等），不会触碰项目源代码。

Q3：白名单是全局生效的还是按命令生效的？全局生效。一条ignore add命令对该路径在所有扫描类命令中同时生效。

总结：先加白名单，再放心清理

给重要项目"上保险"其实只需要一行命令。推荐的新手工作流：

1. cleanmymac ignore add保护关键项目
2. cleanmymac ignore list定期核对白名单
3. cleanmymac clean/cleanmymac purge放心清理（首次不加--force）
4. 项目归档后用ignore remove解除保护

按照这个流程，你既能享受到 CleanMyMac CLI 清理数 GB 开发缓存的效率，又能在任何时刻确保重要项目万无一失。🚀