gcc编译时需用-wl,-rpath,路径透传rpath给链接器ld，不可直接写-rpath；正确写法如-wl,-rpath,'$origin/lib'，单引号防shell展开，$origin表示可执行文件所在目录，确保动态库路径可移植。
gcc编译时怎么加-rpath
直接用 -Wl,-rpath,路径，不是 -rpath 本身，因为 rpath 是链接器 ld 的参数，必须通过 -Wl 透传给它。
常见错误写法：-Wl,rpath,/path（漏了短横线）、-Wl,-rpath=/path（等号在 GNU ld 中不被识别）、-rpath /path（gcc 不认识这个选项）。
-
-Wl,-rpath,/usr/local/lib：硬编码绝对路径 -
-Wl,-rpath,'$ORIGIN'：单引号必须，否则 shell 会提前展开$ORIGIN -
-Wl,-rpath,'$ORIGIN/../lib'：相对可执行文件位置向上一级再进 lib 目录 - 多个路径用冒号拼接：
-Wl,-rpath,'$ORIGIN:$ORIGIN/lib'
为什么用 $ORIGIN 而不是绝对路径
绝对路径会让程序绑定死在某台机器的某个目录，无法移植；$ORIGIN 表示可执行文件自身所在目录，打包分发时只要保持二进制和 so 文件相对位置不变，就能自动找到库。
注意：$ORIGIN 是 ELF 动态段支持的特殊 token，不是 shell 变量，不能用双引号包裹（会被 shell 展开为空），也不能省略引号——否则空格或特殊字符会导致链接失败。
- 正确：
-Wl,-rpath,'$ORIGIN/lib' - 错误：
-Wl,-rpath,"$ORIGIN/lib"（shell 展开后变成-Wl,-rpath,/lib） - 错误：
-Wl,-rpath,$ORIGIN/lib（未加引号，$ORIGIN被 shell 当作变量，值为空）
运行时查不到库？先看 rpath 是否生效
用 readelf -d 程序 | grep -E '(RPATH|RUNPATH)' 查看是否真的写进去了。如果输出为空，说明 -Wl,-rpath 没生效，常见原因：
- 链接命令里没加
-Wl,-rpath，只加了-L（那是编译时找库，不影响运行时） - 用了
CMAKE_SKIP_RPATH或CMAKE_SKIP_BUILD_RPATH=ON（CMake 用户容易踩） - 链接器被覆盖，比如用了
gold或lld，某些旧版本对$ORIGIN支持不全 - 目标平台是 musl libc（如 Alpine Linux），
$ORIGIN支持较晚，需确认 libc 版本
rpath 和 LD_LIBRARY_PATH 冲突怎么办
rpath（或 RUNPATH）优先级高于 LD_LIBRARY_PATH，但若你发现设置了 rpath 还是加载失败，可能是因为：
- 动态链接器忽略
rpath：程序 setuid/setgid 时，为安全起见，glibc 会丢弃rpath和LD_LIBRARY_PATH - 路径中存在符号链接：
$ORIGIN解析的是真实路径（readlink -f结果），不是链接路径 - 路径权限问题：目标目录不可读、不可执行（x 权限对目录是必须的）
- 32/64 位不匹配：
libfoo.so是 64 位，但程序是 32 位（或反之），ldd会报 “not found”，实际是架构不兼容
调试建议：运行前加 LD_DEBUG=libs ./程序，看动态链接器实际尝试了哪些路径、在哪一步失败。
