Clang编译时加-rpath需用-Wl,-rpath,/path/to/lib，路径必须以/开头、多路径用:分隔；$ORIGIN需单引号包裹或反斜杠转义；CMake中通过set_target_properties设置INSTALL_RPATH并启用CMAKE_BUILD_RPATH_USE_ORIGIN。
clang编译时怎么加-rpath
直接用 -Wl,-rpath,/path/to/lib 就行，-Wl 是告诉 clang 把后面的参数透传给链接器 ld。关键点是：路径必须写全，不能省略开头的 /（否则会被当成相对路径，多数情况下失效）；多个路径用冒号 : 拼接，比如 -Wl,-rpath,/usr/local/lib:/opt/mylib。
常见错误：
• 写成 -rpath=/path（漏了 -Wl, 前缀），clang 会报 unknown argument
• 写成 -Wl,-rpath,./lib（用相对路径），运行时找不到，因为动态链接器不按当前目录解析 .
• 在 macOS 上误用 -rpath 而不是 -install_name 或 -headerpad_max_install_names，导致 dylib 加载失败
$ORIGIN 怎么安全嵌入
$ORIGIN 表示可执行文件所在目录，是跨平台最稳妥的相对路径方案，但 shell 会提前展开 $ 符号，导致它变成空字符串。解决方法只有两个字：转义。
正确写法：
• clang -Wl,-rpath,'$ORIGIN/../lib' main.c -o main（单引号包裹，阻止 shell 展开）
• clang -Wl,-rpath,\$ORIGIN/../lib main.c -o main（反斜杠转义）
• 在 Makefile 或 configure 中，要用 $$ORIGIN（双美元符，第一层被 make 展开，第二层留给链接器）
验证是否生效：
• readelf -d ./main | grep RUNPATH（Linux）
• otool -l ./main | grep -A2 LC_RPATH（macOS）
看到输出里有 $ORIGIN 字样才算成功
clang 链接动态库时路径不生效？检查这三处
即使加了 -rpath，运行时仍报 libxxx.so: cannot open shared object file，大概率是以下某一处没对：
-
ldd ./main看是否列出目标库——如果没列出来，说明链接阶段根本没找到，先检查-L和-l是否配对、库名拼写是否正确（比如-lcurl对应的是libcurl.so） -
readelf -d ./main看RUNPATH或RPATH字段是否存在且路径正确——若字段为空，说明-Wl,-rpath没生效，回头查引号或转义 - 确认目标库文件真实存在且权限可读——尤其注意交叉编译后，库文件架构是否匹配（比如 aarch64 编译的可执行文件去加载 x86_64 的 .so）
CMake 里怎么等价实现
CMake 不直接暴露 -Wl,-rpath，得靠 set_target_properties 或 link_directories + target_link_libraries 组合。
推荐写法：
• set_target_properties(myapp PROPERTIES INSTALL_RPATH "$ORIGIN/../lib")
• set_target_properties(myapp PROPERTIES BUILD_RPATH "$ORIGIN/../lib")（开发阶段用）
• 必须配合 cmake -DCMAKE_BUILD_RPATH_USE_ORIGIN=ON 才能让 $ORIGIN 生效
注意：
• LINK_DIRECTORIES 只影响编译期查找，不影响运行时路径
• target_link_libraries(myapp PRIVATE mylib) 中的 mylib 必须是已定义的 target，否则 CMake 不会自动注入 rpath
• macOS 上还需额外设 INSTALL_NAME_DIR，否则 dylib 的内部 ID 路径不对
真正容易被忽略的，是 $ORIGIN 的解析时机——它只在程序启动时求值一次，且基于可执行文件的磁盘位置，不是 cd 后的当前目录。所以哪怕你把二进制挪到别的路径运行，只要库放在预设的相对位置，就能自动找到。
