-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 都关键。