-rpath在交叉编译中常失效，根本原因是未配合--sysroot使用：llvm会将-rpath路径按--sysroot前缀重写进dt_runpath，缺省时误用主机根目录导致目标机路径错乱；正确做法是--sysroot指定目标sysroot路径，并用-wl,-rpath,/usr/lib让链接器写入相对sysroot的运行时库搜索路径。
交叉编译时 -rpath 为什么经常失效？
直接加 -Wl,-rpath,/path/to/libs 在交叉编译中大概率不生效，不是链接器 bug，而是因为没配 --sysroot。LLVM（Clang）在启用 -rpath 时，会把路径按 --sysroot 前缀重写进 ELF 的 DT_RUNPATH 字段；若未指定 --sysroot，它会尝试用主机系统根目录（如 /）做前缀，导致目标机上路径错乱甚至为空——运行时 ld.so 根本不会查这个路径。
--sysroot 必须和 -rpath 配合使用
正确做法是：先准备好目标平台的 sysroot 目录（含 usr/lib、lib、usr/include 等），再让 Clang 明确知道它的位置：
-
--sysroot=/path/to/aarch64-linux-gnu-sysroot—— 所有头文件、库搜索都基于此根目录 -
-Wl,-rpath,'$ORIGIN/../lib'或-Wl,-rpath,/usr/lib—— 此处路径会被自动补上前缀，最终写入 ELF 的是/path/to/aarch64-linux-gnu-sysroot/usr/lib - 必须用
-Wl,前缀把-rpath透传给链接器 LLD 或 GNU ld，不能直接写-rpath
示例命令：
clang -target aarch64-linux-gnu \ --sysroot=/opt/sysroots/aarch64-linux-gnu \ -Wl,-rpath,/usr/lib \ main.c -o main
检查结果：
readelf -d main | grep RUNPATH
应看到类似 0x000000000000001d (RUNPATH) Library runpath: [/usr/lib]，且运行时 ldd main 能正确解析依赖。
用 -rpath-link 替代 -rpath 仅解决链接阶段问题
如果只是想让链接通过（比如动态库在 sysroot 外的临时目录），但不希望运行时硬编码路径，就该用 -rpath-link：
-
-Wl,-rpath-link,/tmp/cross-libs—— 仅链接时查找，不写入 ELF - 它不依赖
--sysroot重写，路径原样传给链接器 - 适合 CI 中临时提供 .so、或调试阶段绕过 sysroot 不完整的问题
- 但无法解决运行时找不到库的问题，只是“骗过链接器”
常见陷阱：CMake 里 INSTALL_RPATH 和交叉编译冲突
CMake 默认用 INSTALL_RPATH 控制 -rpath，但在交叉编译中容易出错：
- 若未设置
CMAKE_SYSROOT，CMake 生成的-rpath仍基于构建机路径 - 必须显式设置：
set(CMAKE_SYSROOT /path/to/sysroot)和set(CMAKE_INSTALL_RPATH "/usr/lib") - 更稳妥的做法是关闭自动 RPATH：
set(CMAKE_SKIP_RPATH TRUE)，改用target_link_options(target PRIVATE "-Wl,-rpath,/usr/lib") - 注意：CMake 3.14+ 才支持
target_link_options，旧版本需用set_target_properties(... LINK_FLAGS ...)
RPATH 的本质是部署问题，不是编译问题。真正难的从来不是加参数，而是确保 --sysroot 下的 lib 和 usr/lib 里真有你要的 .so，且 ABI 兼容——这点比任何 flag 都关键。
