macOS 开发环境清理清单

清理不是勇敢删除，而是知道哪些东西真的能重建。

清理开发机不要靠玄学：先看磁盘占用，再处理缓存、包管理器、模拟器、日志和旧构建产物。每一步都应该可回滚、可解释，别一上来就对系统目录下狠手。

我的底线很简单：先观察，再清理，最后复查。跳过观察直接删除，就是拿开发环境开盲盒。

先看空间从哪里来

第一步永远是看磁盘占用。不要凭感觉猜“肯定是缓存”，因为真正吃空间的可能是模拟器、Docker 镜像、旧构建产物或下载目录。

df -h
du -sh ~/Library/Developer/* 2>/dev/null
du -sh ~/Library/Caches/* 2>/dev/null | sort -h

这些命令只读，不会修改系统。它们能帮你把问题从“磁盘满了”拆成“哪个目录正在变胖”。

优先处理的区域

• Xcode DerivedData 和旧模拟器。
• 包管理器缓存，比如 Homebrew、npm、pnpm、Bun。
• 项目里的 .next、dist、node_modules 等可重建目录。
• 长期没清的日志和下载文件。

再做可回滚清理

清理动作要分批做。比如先处理单个项目的构建产物，再处理包管理器缓存，最后才看开发工具目录。

一个项目级检查可以很简单：

du -sh .next dist node_modules 2>/dev/null
git clean -ndX

这里的 git clean -ndX 是 dry run，只会预览会被清理的忽略文件，不会真的删除。确认范围以后，再决定是否手动处理。相比之下，删除全局配置、证书、数据库文件就完全不是一回事。

最后建立维护节奏

开发机不需要天天大扫除。更好的节奏是每个月看一次磁盘占用，或者在系统升级、Xcode 升级、大项目切换之后检查一遍。

可以参考 Apple 的 macOS 用户指南 确认系统工具的边界，再结合项目自己的构建命令做复查。

1. 记录清理前空间。
2. 只清理可解释目录。
3. 运行项目检查。
4. 记录清理后空间。

清理的目标是稳定

省空间只是结果，稳定才是目标。一个清理流程如果不能解释、不能回滚、不能验证，那就不是维护，是赌博。开发机可不是拿来赌的。

维护节奏表

• 用 Space 预览可疑文件。
• 把 缓存 和用户数据分开处理。
• 清理前记录一次磁盘占用。