-Wl,-rpath 不能直接写成 -rpath 因为 -rpath 是链接器 ld 的参数，GCC 前端不识别，必须通过 -Wl, 透传给链接器；否则报错 unrecognized command-line option。
为什么 -Wl,-rpath 不能直接写成 -rpath
因为 -rpath 是链接器（ld）的参数，不是 GCC 前端识别的选项。GCC 本身不处理运行时库搜索路径，它只是把参数“透传”给底层链接器。所以必须用 -Wl, 告诉 GCC：“接下来这部分请原样交给链接器”。漏掉 -Wl,，GCC 会报错 unrecognized command-line option '-rpath'。
-Wl,-rpath 后面的路径怎么写才生效
路径可以是绝对路径，也可以是相对路径（但相对路径是相对于可执行文件所在目录，不是编译时的当前目录）。常见写法包括：
-
-Wl,-rpath,/usr/local/lib：绝对路径，最稳妥，启动时直接查该目录 -
-Wl,-rpath,'$ORIGIN/../lib'：使用$ORIGIN（代表可执行文件自身所在目录），单引号防止 shell 提前展开；这是打包分发时推荐的方式 -
-Wl,-rpath,'$ORIGIN/lib:$ORIGIN/../deps/lib'：多个路径用冒号分隔，注意整个字符串需加单引号避免空格或冒号被 shell 截断
⚠️ 容易踩的坑：$ORIGIN 必须全大写、必须带美元符、不能写成 $origin 或 $$ORIGIN；双引号在某些 shell 下会让 $ORIGIN 被提前解释为空，务必用单引号包裹整个 -rpath=... 值。
和 LD_LIBRARY_PATH 冲突时谁优先
运行时动态链接器按固定顺序查找共享库：DT_RPATH / DT_RUNPATH（即 -rpath 写入的路径）→ LD_LIBRARY_PATH → /etc/ld.so.cache → /lib 和 /usr/lib。所以 -Wl,-rpath 指定的路径优先级高于 LD_LIBRARY_PATH —— 除非你显式用了 -Wl,--disable-new-dtags（旧语义），此时它退化为低优先级的 DT_RPATH；现代链接默认启用 new-dtags，生成的是高优先级的 DT_RUNPATH。
验证方式：readelf -d ./myapp | grep rpath，看到的是 0x000000000000001d (RUNPATH) 还是 0x000000000000000f (RPATH) 就清楚了。
静态链接 vs 动态链接下 -Wl,-rpath 是否有效
完全无效。如果用了 -static 或链接了所有依赖的 .a 文件，生成的是纯静态可执行文件，根本不需要运行时找 .so，-rpath 会被忽略（readelf -d 也看不到相关条目）。只有在生成动态可执行文件（默认行为）、且依赖外部 .so 时，-rpath 才起作用。
另外注意：-Wl,-rpath 只影响**运行时**库查找，不影响编译期头文件包含或链接期符号解析 —— 那些由 -I 和 -L 控制。
