macos应用启动报“dylib not found”本质是运行时rpath与dylib实际路径不匹配；需用otool检查依赖和rpath，将dylib放入frameworks目录，并用install_name_tool修正install name、引用路径及添加rpath。
MacOS应用启动时报“dylib not found”或“Library not loaded”，本质是运行时找不到所需的动态链接库（.dylib）。这不是编译问题，而是运行时路径（rpath）和加载路径不匹配导致的。解决核心在于让系统在启动时能准确定位到 dylib 文件位置。
检查缺失的 dylib 和当前加载路径
用 otool -L 查看可执行文件依赖哪些 dylib，以及它期望从哪加载：
otool -L MyApp.app/Contents/MacOS/MyApp
输出中每行类似：@rpath/libfoo.dylib (compatibility version 1.0.0, current version 1.0.0)
说明它依赖 libfoo.dylib，且会在 @rpath 展开后的路径中查找。若该 dylib 实际不在这些路径下，就会失败。
再用 otool -l 查看二进制中记录的 RPATH 加载规则：
otool -l MyApp.app/Contents/MacOS/MyApp | grep -A2 LC_RPATH
常见值如：@executable_path/../Frameworks 或 @loader_path/../lib。注意：@rpath 是占位符，需由 rpath 记录的实际路径来解析。
把 dylib 放到正确位置并修正链接路径
推荐将 dylib 放入 App Bundle 的 Frameworks 目录（符合 macOS 安全与沙盒规范），然后更新可执行文件对 dylib 的引用路径：
- 把
libfoo.dylib拷贝进MyApp.app/Contents/Frameworks/ - 用
install_name_tool修改 dylib 的 install name（即它声明自己是谁）：install_name_tool -id "@rpath/libfoo.dylib" MyApp.app/Contents/Frameworks/libfoo.dylib
- 修改可执行文件对它的引用，指向 @rpath：
install_name_tool -change "libfoo.dylib" "@rpath/libfoo.dylib" MyApp.app/Contents/MacOS/MyApp
- 为可执行文件添加 rpath，使其知道 @rpath 展开为 Frameworks 目录：
install_name_tool -add_rpath "@executable_path/../Frameworks" MyApp.app/Contents/MacOS/MyApp
验证修复是否生效
完成上述操作后，再次运行 otool -L，确认所有 dylib 都显示为 @rpath/xxx.dylib，且 otool -l | grep RPATH 显示已添加对应 rpath。
接着用 dyld_info -rebase 或直接启动测试：
./MyApp.app/Contents/MacOS/MyApp
如仍失败，可临时启用 dyld 调试日志定位问题：
DYLD_PRINT_LIBRARIES=1 DYLD_PRINT_LIBRARIES_POST_LAUNCH=1 ./MyApp.app/Contents/MacOS/MyApp
终端会打印每个尝试加载的库及其路径，便于判断哪一步没找到。
自动化与构建集成建议
手动改路径易出错，建议在构建流程中固化处理：
- Xcode 工程中，在 Build Settings → Runpath Search Paths 添加
@executable_path/../Frameworks - 确保 dylib 的 Installation Directory 设为
@rpath - 使用
cpack（CMake）或macdeployqt（Qt）等工具自动拷贝依赖并重写路径 - 自定义脚本用
find .app -name "*.dylib" -exec install_name_tool -id "@rpath/{}" {} \;批量标准化 install name
