精准清理 macOS 开发工具缓存需分步处理:Homebrew 执行 brew cleanup 和 autoremove 或删 $(brew --cache);Xcode 清理 Archives、DerivedData 及 CommandLineTools/Packages;npm/yarn/pod/carthage 各自清缓存;系统级则清理 /Library/Updates/、App Store 缓存及 Xcode 安装器残留。
清理 macos 开发工具的安装缓存,关键不是“全删”,而是精准清除各工具在不同路径留下的安装包、构建产物和元数据缓存。这些缓存不随软件卸载自动消失,长期堆积可占数十 gb 空间,且可能干扰新版本安装或构建行为。
清理 Homebrew 安装缓存
Homebrew 下载的源码包(.tar.gz)和预编译二进制(bottles)默认存在 /opt/homebrew/cache(Apple Silicon)或 /usr/local/Homebrew/cache(Intel),不会自动清理。
- 执行
brew cleanup:删除所有旧版本 formula 的缓存包 - 再运行
brew autoremove:移除已卸载 formula 的残留依赖包 - 如需彻底清空(例如换源或重装前),可手动删缓存目录:
rm -rf $(brew --cache)
清除 Xcode 相关安装与构建缓存
Xcode 安装器、命令行工具及构建过程会留下多类缓存,尤其 ~/Library/Developer/Xcode/Archives 和 /Library/Developer/CommandLineTools 中的旧安装包易被忽略。
- 删历史归档(IPA / xcarchive):
rm -rf ~/Library/Developer/Xcode/Archives - 清衍生数据(含模拟器快照、索引等):
rm -rf ~/Library/Developer/Xcode/DerivedData - 删旧版命令行工具缓存(如有多个版本):
sudo rm -rf /Library/Developer/CommandLineTools/Packages/* - 检查并清理系统级 Xcode 安装缓存:
ls /Library/Developer/Caches,对确认为 Xcode 临时包的子目录(如com.apple.dt.Xcode)可安全删除
清理 npm/yarn/pod/carthage 的安装依赖缓存
这些工具在下载依赖时会缓存 tarball 或构建产物,重复安装同一版本时直接复用——但旧版本极少被自动淘汰。
- npm:
npm cache clean --force(推荐)或rm -rf ~/.npm - yarn:
yarn cache clean - CocoaPods:
pod cache clean --all - Carthage:
carthage clear-cache(若使用) - 注意:
~/.pnpm-store(如用 pnpm)也需单独清理:pnpm store prune
处理系统级安装器残留(如 macOS 更新、App Store 安装包)
开发环境常伴随系统更新、Xcode 更新或 App Store 应用安装,其临时包藏在系统受保护路径中。
- 查看大体积更新包:
sudo du -sh /Library/Updates/* 2>/dev/null | sort -hr | head -5 - 安全清理旧更新(保留最新一版即可):
sudo rm -rf /Library/Updates/041-* /Library/Updates/13.*(示例) - 清 App Store 下载缓存:
rm -rf ~/Library/Caches/com.apple.appstore/* - 删 Xcode 安装器残留(如升级失败后):
ls -la / | grep "Install macOS\|SharedSupport",确认无用后sudo rm -rf


















