otool -l仅显示编译时依赖路径，真实运行时加载路径需用dyld_print_libs=1验证；homebrew库版本跃迁、rpath缺失或/usr/lib误操作是常见根源。
otool -L 查不到真实加载路径？用 dyld_print_libs 看运行时行为
静态依赖树（otool -L）只反映编译时写死的链接路径，不等于实际运行时加载的库。很多“闪退但没报错”或“符号找不到”的问题，根源是 dyld 在运行时从 DYLD_LIBRARY_PATH、DYLD_FALLBACK_LIBRARY_PATH 或 LC_RPATH 中优先选了错误版本。
验证真实加载路径最直接的方式是：
运行 dyld_print_libs=1 your_app 2>&1 | grep libname（把 libname 换成你怀疑的库名，比如 libcurl 或 libssl）。输出里显示的路径才是 dyld 最终打开的那个文件。
常见陷阱：
- Homebrew 安装的
libiconv和系统/usr/lib/libiconv.dylib同名但 ABI 不兼容，otool -L显示的是前者，而dyld_print_libs显示后者被加载——说明环境变量或 rpath 把它绕过去了 - 某些 GUI 应用会继承 LaunchServices 的环境，
dyld_print_libs在终端里跑可能不生效；此时改用launchctl setenv DYLD_PRINT_LIBS 1再启动应用
install_name_tool 改依赖路径时，-change 和 -add_rpath 要配合用
单独用 install_name_tool -change 替换一个 .dylib 路径，只是硬编码新地址；如果那个新地址本身又依赖其他库（比如 /opt/homebrew/lib/libpq.dylib 依赖 libssl），而新路径不在 dyld 搜索范围内，照样报 image not found。
正确做法是两步走：
- 先用
install_name_tool -change "old/path/libxxx.dylib" "/opt/homebrew/lib/libxxx.dylib" /path/to/binary - 再补一句
install_name_tool -add_rpath "/opt/homebrew/lib" /path/to/binary
这样 dyld 运行时就能顺着 rpath 找到所有间接依赖。检查是否生效：用 otool -l /path/to/binary | grep -A2 LC_RPATH 确认 rpath 已写入，且路径存在。
注意：-add_rpath 添加的是运行时搜索路径，不是编译期 -L；它比硬编码 -change 更健壮，尤其适合多版本共存场景。
brew reinstall --build-from-source 不等于“重装就完事”
Homebrew 的二进制瓶（bottle）是为特定 macOS SDK 版本构建的，大版本升级后（如从 Sonoma 到 Sequoia），旧瓶里的动态库 ID（LC_ID_DYLIB）可能仍指向已失效的 SDK 路径（如 /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX14.2.sdk/usr/lib/libz.tbd）。
只运行 brew reinstall formula-name 可能还是拉取旧瓶；必须加 --build-from-source 强制本地编译：
brew update && brew reinstall --build-from-source ffmpeg- 过程中若卡在 configure 阶段报
library not found for -lssl，说明其依赖（如openssl@3）未被正确 link；先brew link openssl@3，再重试 - 编译成功后，用
otool -D /opt/homebrew/bin/ffmpeg检查主 ID 是否已变成@rpath/libffmpeg.dylib类形式，而非带 SDK 版本号的绝对路径
别碰 /usr/lib，也别信“重装 Xcode 命令行工具就能好”
macOS 13+ 起，/usr/lib 下多数系统库受 SIP 保护，不可写也不建议链接。很多教程让你 sudo rm /usr/lib/libcurl.dylib 或 brew link --force curl，这会破坏系统完整性，导致 git、ssh、Xcode 构建链甚至系统偏好设置崩溃。
真正该做的只有三件事：
- 确认你的程序是否真的需要系统库：用
nm -D /usr/lib/libcurl.dylib | grep curl_easy_init和nm -D $(brew --prefix curl)/lib/libcurl.dylib | grep curl_easy_init对比符号是否存在且签名一致；不一致就别强切 - 让程序用 Homebrew 库：通过
install_name_tool -add_rpath加路径，而不是改/usr/lib - 修复被污染的系统工具：如果
git崩溃，先brew uninstall git，再brew install git（不加--build-from-source，让它用静态 OpenSSL 或系统 Security Framework）
最易被忽略的一点：Homebrew 公式里声明的 depends_on "openssl" 默认指最新版（如 openssl@3），但老程序只认 libssl.1.1.dylib。这种隐式版本跃迁不会报错，只会静默失败——得靠 brew deps --tree --installed + ls -l $(brew --prefix openssl)/lib/ 手动对齐。
