如何通过CMake Install使可执行文件链接到安装后的共享库？

这个问题的核心是安装后的可执行文件缺少正确的运行时路径（RPATH）配置——构建阶段程序能找到构建树里的库，但安装后路径变了，默认的RPATH没有指向新的lib目录，所以找不到lib/foo.so。下面是具体的解决步骤：

1. 在根CMakeLists.txt中配置RPATH #

在项目根目录的CMakeLists.txt开头添加以下配置，确保安装后的程序能定位到同级的lib目录：

# 设置安装后的运行时查找路径：让bin目录下的程序去上级目录的lib找库
# $ORIGIN是特殊变量，代表当前可执行文件所在的目录
set(CMAKE_INSTALL_RPATH "$ORIGIN/../lib")

# 允许CMake将构建时的链接路径纳入安装后的RPATH（可选，但能兼容更多场景）
set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)

如果你的安装路径是固定的绝对路径，也可以用绝对路径配置：

set(CMAKE_INSTALL_RPATH "${CMAKE_INSTALL_PREFIX}/lib")

不过用$ORIGIN的相对路径更灵活，不管你把项目安装到哪个目录，bin和lib的相对关系不变就能正常工作。

2. 确保子目录的CMake配置正确 #

foo子目录的CMakeLists.txt #

你的原有配置没问题，保持即可：

add_library(foo SHARED foo.cpp)
target_include_directories(foo PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

install(TARGETS foo LIBRARY DESTINATION lib)

test_foo子目录的CMakeLists.txt #

确保正确链接foo库，安装命令也没问题：

add_executable(test_foo test_foo.cpp)
# 链接foo库，PRIVATE表示只在编译test_foo时需要
target_link_libraries(test_foo PRIVATE foo)

install(TARGETS test_foo RUNTIME DESTINATION bin)

3. 执行安装流程 #

按正常步骤构建并安装：

# 创建构建目录并配置
cmake -S . -B build -DCMAKE_INSTALL_PREFIX=/your/install/path
# 编译
cmake --build build
# 安装
cmake --install build

4. 验证RPATH是否生效 #

安装完成后，用以下命令检查可执行文件的RPATH配置：

readelf -d /your/install/path/bin/test_foo | grep RPATH

如果输出里包含$ORIGIN/../lib（或者你设置的绝对路径），说明配置成功，此时运行bin/test_foo就能正常找到lib/foo.so了。

额外说明 #

• 如果你之前已经构建过项目，记得删除build目录重新配置，避免旧的缓存影响。
• 不同系统的RPATH语法略有差异，但$ORIGIN在Linux和类Unix系统（macOS下CMake会自动适配为@loader_path）都能正常工作。

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