设置$ORIGIN为rpath后Linux二进制文件仍无法找到本地共享库

近几个月我用C++和SDL2（图形库）开发了一款游戏，现已完成准备发布。Windows版本运行正常，但Linux版本存在问题。由于SDL2及负责文本渲染的SDL2_ttf并非标准库，我将.so文件与二进制文件一同打包并动态链接，但在未安装SDL2_ttf的其他Linux系统上程序无法启动。执行readelf -d命令显示runpath确实为$ORIGIN，但ldd命令显示库未找到。开发环境为Linux Mint下的VSCode。

附相关信息： #

tasks.json配置： #

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: g++ build active file",
            "command": "/usr/bin/g++",
            "args": [
                "-no-pie",
                "-static-libstdc++",
                "-static-libgcc",
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}",
                "-Wl,-R,'$ORIGIN'",
                "-lSDL2main",
                "-lSDL2",
                "-lSDL2_ttf"
            ],
            "options": {
                "cwd": "${fileDirname}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "detail": "Task generated by Debugger."
        }
    ],
    "version": "2.0.0"
}

全新Linux Mint虚拟机上的ldd输出前几行： #

linux-vdso.so.1 (0x00007ffc82c52000)
libSDL2-2.0.so.0 => /lib/x86_64-linux-gnu/libSDL2-2.0.so.0 (0x00007f696c4ff000)
libSDL2_ttf-2.0.so.0 => not found

readelf -d输出： #

Dynamic section at offset 0x11ed98 contains 28 entries:
  Tag        Type                         Name/Value
 0x0000000000000001 (NEEDED)             Shared library: [libSDL2-2.0.so.0]
 0x0000000000000001 (NEEDED)             Shared library: [libSDL2_ttf-2.0.so.0]
 0x0000000000000001 (NEEDED)             Shared library: [libc.so.6]
 0x0000000000000001 (NEEDED)             Shared library: [ld-linux-x86-64.so.2]
 0x000000000000001d (RUNPATH)            Library runpath: [$ORIGIN]
 0x000000000000000c (INIT)               0x404000
 0x000000000000000d (FINI)               0x4d96c8
 0x0000000000000019 (INIT_ARRAY)         0x518890
 0x000000000000001b (INIT_ARRAYSZ)       72 (bytes)
 0x000000000000001a (FINI_ARRAY)         0x5188d8
 0x000000000000001c (FINI_ARRAYSZ)       8 (bytes)
 0x000000006ffffef5 (GNU_HASH)           0x4003e8
 0x0000000000000005 (STRTAB)             0x4014d8
 0x0000000000000006 (SYMTAB)             0x400410
 0x000000000000000a (STRSZ)              2182 (bytes)
 0x000000000000000b (SYMENT)             24 (bytes)
 0x0000000000000015 (DEBUG)              0x0
 0x0000000000000003 (PLTGOT)             0x520000
 0x0000000000000002 (PLTRELSZ)           4080 (bytes)
 0x0000000000000014 (PLTREL)             RELA
 0x0000000000000017 (JMPREL)             0x402040
 0x0000000000000007 (RELA)               0x401f98
 0x0000000000000008 (RELASZ)             168 (bytes)
 0x0000000000000009 (RELAENT)            24 (bytes)
 0x000000006ffffffe (VERNEED)            0x401ec8
 0x000000006fffffff (VERNEEDNUM)         2
 0x000000006ffffff0 (VERSYM)             0x401d5e
 0x0000000000000000 (NULL)               0x0

游戏文件夹内容： #

二进制可执行文件与libSDL2-2.0.so.0、libSDL2_ttf-2.0.so.0等.so文件处于同一目录下。

1. 修复RUNPATH的引号问题 #

你的tasks.json中-Wl,-R,'$ORIGIN'的单引号会被Shell解析，可能导致RUNPATH设置异常。修改为：

-Wl,-R,$ORIGIN

或用双引号包裹避免Shell扩展：

-Wl,-R,"$ORIGIN"

重新编译后用readelf -d确认RUNPATH为[$ORIGIN]。

2. 检查库文件的完整性 #

确认打包的SDL2_ttf库文件名与程序依赖的libSDL2_ttf-2.0.so.0完全一致。系统中的该文件可能是符号链接，需复制实际库文件并创建对应链接：

cp /usr/lib/x86_64-linux-gnu/libSDL2_ttf-2.0.so.0.* ./
ln -s libSDL2_ttf-2.0.so.0.* libSDL2_ttf-2.0.so.0

3. 检查SDL2_ttf的依赖链 #

SDL2_ttf可能依赖其他库（如freetype），用ldd libSDL2_ttf-2.0.so.0查看依赖，将缺失的库一并打包到程序目录。

4. 临时测试加载路径 #

通过环境变量指定库路径测试：

LD_LIBRARY_PATH=. ./你的游戏程序

若能运行，检查库文件权限（执行chmod 644 *.so赋予可读权限）或RUNPATH设置是否仍有问题。

5. 改用RPATH（可选） #

部分旧系统对RUNPATH支持不佳，改用RPATH参数：

-Wl,-rpath,$ORIGIN

RPATH会优先于系统路径查找库文件。

内容的提问来源于stack exchange，提问作者TheCubicCat