brew cleanup 是释放 homebrew 占用磁盘空间的核心命令，支持基础清理、强制清理、定向清理、预览效果及手动清除五种方式，可释放5–15 gb常规空间或额外3–8 gb冗余数据。
Mac上/usr/local目录长期积累的旧版Homebrew包、手动编译安装的二进制文件、过期头文件和库文件，会持续占用数GB空间并可能引发命令冲突——该目录不属于系统保护范围，但直接rm -rf风险极高，因其中混杂着当前运行依赖项、活跃brew服务进程引用的符号链接，以及未被brew list识别的交叉编译产物。
确认当前活跃的Homebrew环境与已弃用包
打开终端，执行：
brew doctor → 观察是否提示“Your system is ready to brew.”；若报错含“unbrewed”，说明存在非brew管理的残留；
brew outdated → 列出所有可升级但尚未更新的包，这些是明确需清理的旧版本候选；
brew list --versions | grep -E ' [0-9]+\.[0-9]+\.[0-9]+.*[0-9]+\.[0-9]+\.[0-9]+' → 筛出带多个版本号的包（如node 18.17.0 20.12.2），高亮显示旧版编号。
这一步不可跳过：若跳过，后续删除可能误毁当前正在使用的版本，导致终端命令如git、curl、python3突然失效。
安全卸载旧版Homebrew包（方法一：brew自带卸载）
对上一步中确认的旧版本包，逐个执行：
brew uninstall 包名@旧版本号 → 例如 brew uninstall node@18.17.0；
brew cleanup → 清理所有包的旧版本缓存和下载归档；
brew autoremove → 移除已无依赖关系的孤立包（如旧版openssl被新版替代后残留的libressl）。
【务必在执行brew uninstall前，先用brew switch 包名 新版本号验证新版本能正常调用】，否则卸载后可能无法回退。
手动清理非Homebrew管理的/usr/local残留（方法二：精准定位+交互式删除）
第一步：进入目录并按修改时间排序
cd /usr/local → ls -lt | head -20 → 快速识别近半年未更新的可疑目录（如old-python、legacy-ffmpeg、zlib-1.2.8）；
第二步：检查该目录是否被当前进程引用
sudo lsof +D /usr/local/旧目录名 2>/dev/null | head -5 → 若输出为空，说明无活跃进程占用；若有输出（如node或make进程正读取其中头文件），立即中止操作；
第三步：验证符号链接指向
ls -la /usr/local/bin/ | grep 旧目录名 → 查看是否有软链仍指向该路径；若有，且对应命令已通过brew重装，说明该旧目录纯属冗余；
第四步：交互式删除
sudo rm -ri 旧目录名 → 输入y逐个确认，避免通配符误删；
删除后立即执行hash -r → 刷新shell命令哈希表，防止终端仍调用已删二进制文件的缓存路径。
清除/usr/local下隐藏的编译中间产物与临时文件
方法1：清理标准构建残留
sudo find /usr/local -name "*.o" -o -name "*.a" -o -name "*.so" -o -name "Makefile*" -mtime +180 -delete 2>/dev/null；
方法2：定位并删除遗留的configure缓存
sudo find /usr/local -path "*/build" -o -path "*/tmp" -o -path "*/cache" -type d -empty -delete 2>/dev/null；
方法3：扫描未注册到pkgutil的孤立目录
pkgutil --pkgs | xargs -I {} pkgutil --files {} 2>/dev/null | grep "^usr/local/" | cut -d/ -f1-4 | sort -u > /tmp/brew_managed.txt；
find /usr/local -mindepth 1 -maxdepth 3 -type d | grep -v -f /tmp/brew_managed.txt | grep -E '/usr/local/(bin|share|lib|include)' → 输出即为极可能废弃的手动安装目录，人工核对后删除。
