Debian下CMake非标准路径安装后，应用无法加载共享库的解决方法

我在Debian系统里用CMake构建一个包含共享库和可执行文件的项目，核心的CMakeLists.txt代码是这样的：

add_library(mylib SHARED lib.cpp) #creates libmylib.so
add_executable(myapp main.cpp)
target_link_libraries(myapp my-lib)
install(TARGETS mylib myapp RUNTIME DESTINATION bin LIBRARY DESTINATION lib )

当我设置-DCMAKE_INSTALL_PREFIX=/usr安装时，程序运行完全正常，但如果把安装路径改成/opt/myapp或者/usr/local这类路径，执行/opt/myapp/bin/myapp的时候，应用就找不到对应的.so库了。

我知道可以通过脚本设置LD_LIBRARY_PATH来解决，但这只是临时方案，而且还得在配置阶段生成脚本。我想找个原生的方法，在配置、编译或者安装阶段就解决这个问题，不需要用户修改~/.bashrc或者~/.profile，直接从任意路径都能执行应用，请问有没有这样的方法？

针对这个问题，有几个原生的解决方案，完全不需要依赖临时环境变量脚本，从配置或安装阶段就能彻底解决：

方法1：用CMake配置RPATH（最推荐的方案） #

RPATH是嵌入在可执行文件内部的库搜索路径，CMake可以直接帮你配置这个参数，完全不需要用户做额外操作。修改你的核心CMakeLists.txt，添加以下内容：

# 给可执行文件设置安装后的RPATH，让它能定位到同目录上级的lib文件夹
set_target_properties(myapp PROPERTIES
    INSTALL_RPATH "$ORIGIN/../lib"
    INSTALL_RPATH_USE_LINK_PATH TRUE
)

• $ORIGIN是一个特殊的动态链接器变量，代表当前可执行文件所在的目录，$ORIGIN/../lib正好对应你安装结构里的/opt/myapp/lib（从/opt/myapp/bin往上走一级就是lib目录）。
• INSTALL_RPATH_USE_LINK_PATH会让CMake保留链接阶段的路径信息，同时结合我们设置的INSTALL_RPATH，确保安装后的路径绝对正确。

修改后重新执行cmake .. -DCMAKE_INSTALL_PREFIX=/opt/myapp、make、make install，之后不管你从哪个路径执行/opt/myapp/bin/myapp，动态链接器都会自动找到对应的库文件。

方法2：系统级ldconfig配置 #

如果希望这个共享库能被系统全局识别，也可以通过配置ldconfig来实现，步骤如下：

1. 在CMakeLists.txt里添加安装ldconfig配置文件的指令：

# 把自定义的ldconfig配置文件安装到系统指定目录
install(FILES myapp.conf DESTINATION /etc/ld.so.conf.d/)

2. 在项目根目录创建myapp.conf文件，内容就是你的库安装路径：

/opt/myapp/lib

3. 为了安装后自动更新系统库缓存，在CMake里添加执行ldconfig的指令（需要root权限执行安装）：

install(CODE "execute_process(COMMAND ldconfig)")

这个方法是系统级的，所有用户都能访问到这个库，但需要root权限来安装配置文件，适合需要让多个应用共享这个库的场景。

方法3：将库和可执行文件放到同一目录 #

如果你的项目结构允许，可以把共享库和可执行文件安装到同一个bin目录下，修改CMake的install指令即可：

install(TARGETS mylib myapp 
    RUNTIME DESTINATION bin 
    LIBRARY DESTINATION bin # 将共享库也安装到bin目录
)

这样可执行文件和库在同一个目录下，动态链接器默认会搜索可执行文件所在的目录（这个行为依赖系统配置，相比RPATH方法，可靠性稍弱一些）。

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