homebrew符号链接失效需三步修复：先用find命令识别所有断链，再安全删除断链及空opt目录和cellar空主目录，最后对所需软件执行brew link重建链接并验证。
homebrew 符号链接失效，通常是因为软件重装、架构切换（intel ↔ apple silicon）、手动删了 cellar 里的版本目录，或系统升级后路径错位导致的。这类“断链”不会被 brew uninstall 自动清理，却会引发 command not found、bad cpu type 或 brew link 报错。修复核心是三步：找出来、删干净、补正确。
识别所有已失效的软链接
失效链接多藏在以下三个关键路径：
-
/usr/local/bin（Intel Mac 默认 bin） -
/opt/homebrew/bin（Apple Silicon 默认 bin） -
/usr/local/opt或/opt/homebrew/opt（Formula 的符号链接根目录，如python@3.13 → ../Cellar/python@3.13/3.13.2）
运行这条命令列出所有指向不存在目标的软链接：
find /usr/local/bin /opt/homebrew/bin /usr/local/opt /opt/homebrew/opt -type l -exec test ! -e {} \; -print 2>/dev/null
若提示 Permission denied，在命令前加 sudo；若某路径不存在（例如 M1 上没有 /usr/local/bin），可直接跳过该路径。
安全删除断链和空 opt 目录
确认上一步输出全是你要清理的目标后，执行批量删除：
find /usr/local/bin /opt/homebrew/bin /usr/local/opt /opt/homebrew/opt -type l -exec test ! -e {} \; -print0 2>/dev/null | xargs -0 rm
这比 for 循环更安全，能正确处理含空格的路径。接着清理残留的空壳：
- 删掉
/usr/local/opt和/opt/homebrew/opt下所有指向已不存在 Cellar 版本的链接：find /usr/local/opt /opt/homebrew/opt -type l -exec test ! -e {} \; -delete 2>/dev/null - 清空
/usr/local/Cellar或/opt/homebrew/Cellar中已无实际版本子目录的 Formula 主目录（比如node文件夹下全是空文件夹）：find /usr/local/Cellar /opt/homebrew/Cellar -mindepth 1 -maxdepth 1 -type d -empty -delete 2>/dev/null
重建可用链接并验证
删完断链后，对仍需使用的软件重新建立链接：
- 对单个 Formula（如 PHP）：
brew link php@8.3（若报冲突，加--overwrite） - 对 Python 等带版本号的包，确保你调用的是
python3.13这类带版本名的命令；想启用python，需确认/opt/homebrew/opt/python@3.13/libexec/bin已加入PATH - 运行
brew doctor检查遗留问题，再执行brew cleanup清理旧版本缓存
最后测试关键命令是否生效：which python、php -v、pip3.13 --version 等。
