homebrew依赖冲突需通过精准定位解决：用brew deps --tree、--reverse查依赖关系，brew info看显式声明；实操中先查激活版本，再unlink/link切换测试，必要时reinstall验证；清理用autoremove或rmtree，升级前必run brew outdated和doctor。
Homebrew 本身不主动报错“冲突”，但当你看到 cannot install、Conflicting files、ld: library not found 或 dyld: Library not loaded 这类提示时，基本就是依赖版本打架了——常见于 openssl、python、icu4c、readline 等多版本共存的库。
看清谁依赖谁，别只看表面
直接跑 brew deps 包名 只给一层依赖，没用。真正要查清关系，得组合使用：
-
brew deps --installed --tree：只显示当前已装包的真实依赖树，过滤掉没装的可选依赖 -
brew deps --tree 包名：聚焦单个包，缩进结构一目了然 -
brew deps --reverse 包名：反向查“谁在用这个库”，比如brew deps --reverse openssl@1.1能看出哪些已装软件还绑着它 -
brew info 包名：重点看 Depends on 和 Conflicts with 字段，少数 formula 会显式声明冲突
处理版本冲突的实操路径
冲突不是靠猜，而是靠定位+切换+验证：
Free Ride - Unlimited free AI
下载
一款AI工具，主要用于管理 OpenClaw 所使用的来自 OpenRouter 的免费 AI 模型。自动按质量对模型进行排序，配置回退机制以应对速率限制，并更新 opencla...，适合需要提升相关任务效率的用户。
- 查当前激活的是哪个版本：
brew --prefix openssl，再ls -l $(brew --prefix openssl)/lib/libssl*看软链指向 - 临时切版本测试：
brew unlink openssl && brew link openssl@1.1，然后运行出问题的命令看是否恢复 - 强制重装并盯日志：
brew reinstall --debug --verbose openssl@1.1，留意输出里的 Would link: 和 Conflicting files: - 锁定关键基础依赖防误升：
brew pin openssl@1.1，之后brew upgrade就不会动它
清理冗余和顽固冲突包
卸载一个包，不代表它的依赖自动消失。留下的“孤儿库”反而容易埋雷：
- 先预览再动手：
brew autoremove --dry-run列出所有未被任何已装包依赖的公式 - 执行清理：
brew autoremove，它会顺带运行brew cleanup - 想连根拔起某个主程序及其专属依赖（比如 ffmpeg + 它私有的 libvpx、x264）：
brew tap beeftornado/rmtree后用brew rmtree --dry-run ffmpeg预览，确认无误再执行 - 若某依赖其实还有别的包在用（如 git 也依赖 libiconv），可用
--ignore=libiconv保它
升级前的风险控制习惯
Homebrew 升级不记“快照”，brew upgrade 每次都按最新 Formula 文件重算依赖。旧二进制可能硬编码找老 dylib，一升就崩：
- 升级前必做：
brew outdated，尤其盯住带@的包（如python@3.11、icu4c@73），它们变动风险最高 - 日常维护加一道保险：
brew doctor，出现 Warning: Some installed formulae are deprecated or disabled 往往是依赖链断裂的早期信号 - 对核心工具链（如 cmake、autoconf、pkg-config），建议定期
brew reinstall --build-from-source，避免 bottle 和本地环境 ABI 不匹配
