VSCode 运行 C++ 时的动态链接库 RPATH 与 RUNPATH 在 Linux 下的执行差异-VSCode-PHP中文网

code runner 报共享库找不到错误，根本原因是其执行环境未继承 shell 的 ld_library_path 且 rpath/runpath 配置与工作目录不匹配；动态链接器只认 dt_runpath（存在时 dt_rpath 被忽略），需用 --enable-new-dtags 生成 runpath 并确保 $origin 路径相对于可执行文件当前位置有效。

vscode 运行 c++ 时的动态链接库 rpath 与 runpath 在 linux 下的执行差异

VSCode 本身不参与 RPATH/RUNPATH 的解析，真正起作用的是 Linux 动态链接器 ld-linux.so —— 你在 VSCode 里点运行（比如通过 tasks.json 调用 ./a.out），和在终端里直接执行，行为完全一致；差异只来自二进制本身的链接配置，而非编辑器。

为什么在 VSCode 终端里能跑，但用 Code Runner 扩展就报 `error while loading shared libraries: libxxx.so: cannot open shared object file`

这不是 VSCode 的 bug，而是扩展执行环境与你手动运行时的环境变量、工作目录、以及二进制中嵌入的 DT_RPATH/DT_RUNPATH 共同作用的结果。常见原因：

Code Runner 默认在项目根目录执行命令，而你的 RPATH 可能写的是 $ORIGIN/../lib，但实际库放在 ./lib，路径计算错位
Code Runner 启动时未继承你 shell 中设置的 LD_LIBRARY_PATH（它用的是最小环境），而你的二进制用的是 RUNPATH，优先级低于 LD_LIBRARY_PATH，导致原本靠环境变量兜底的库加载失败
你用 g++ -Wl,-rpath,$ORIGIN/lib 编译，但没加 -Wl,--enable-new-dtags，结果生成的是旧式 DT_RPATH 标签（不可被 LD_LIBRARY_PATH 覆盖），而 Code Runner 又清掉了环境变量，彻底断链

`readelf -d ./a.out | grep -E 'RPATH|RUNPATH'` 看到两个都存在，以哪个为准？

动态链接器只认一个：DT_RUNPATH 存在时，DT_RPATH 被完全忽略 —— 这是 ELF 规范强制要求的互斥行为，不是“优先级高低”的问题，而是“有你就没我”。验证方法：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

用 gcc -Wl,-rpath,/tmp/r1 -Wl,--enable-new-dtags -Wl,-rpath,/tmp/r2 编译，readelf 会只显示 RUNPATH
去掉 --enable-new-dtags，就只显示 RPATH
混用（比如先写 -rpath 再加 --enable-new-dtags 后又写一次 -rpath）不会叠加，后者覆盖前者

在 CMake 中安全设置 `$ORIGIN` 路径，避免部署时找库失败

CMake 的 set_target_properties(... PROPERTIES INSTALL_RPATH ...) 很容易踩坑，关键在于：必须同时控制构建时和安装后的路径行为。推荐写法：

对可执行目标启用 RUNPATH（不是 RPATH）：set_target_properties(myapp PROPERTIES BUILD_RPATH "$ORIGIN/lib" INSTALL_RPATH "$ORIGIN/lib")
强制使用新标签：set_target_properties(myapp PROPERTIES BUILD_RPATH_USE_ORIGIN ON INSTALL_RPATH_USE_ORIGIN ON)
最关键一步：补上 LINK_FLAGS "-Wl,--enable-new-dtags"，否则 CMake 3.19+ 仍可能生成 DT_RPATH
验证：编译后立刻用 readelf -d myapp | grep RUNPATH 确认出现 0x000000000000001d (RUNPATH)，且值含 $ORIGIN

真正容易被忽略的点是：即使你设了 $ORIGIN/lib，如果最终二进制被移动到其他目录（比如从 build/ 拷到 /opt/myapp/bin/），而对应 lib/ 没一起挪过去，$ORIGIN 就指向错位置 —— 它永远相对于**当前可执行文件所在路径**，不是构建路径，也不是 VSCode 工作区路径。