CMake为何未将/home/user/xyz路径下的库添加至RPATH？如何配置使其被包含？

我完全懂你现在的困惑——在Nix环境里构建项目时，Nix仓库里的库自动就被加入了RPATH，可自己手动编译安装到/home/user/xyz下的依赖库却没被包含进去，导致在build目录里跑测试程序或者后续运行时可能找不到这个库对吧？我来给你拆解背后的原因和具体的解决办法。

为什么会出现这种情况？ #

• Nix环境的特殊配置：Nix为了保证构建产物的依赖确定性和可移植性，会在构建环境里给CMake预设一些规则，自动把Nix Store里所有依赖的路径都添加到RPATH中，这是Nix默认帮你做的事情。
• 自定义路径不在默认范围：你安装到/home/user/xyz的库属于本地自定义路径，既不在CMake默认自动识别的系统路径列表里，也不在Nix自动处理的路径范围内，所以CMake不会主动把它加入RPATH。

具体解决办法 #

1. 直接手动指定RPATH路径 #

如果想快速解决，最直接的方式就是在运行CMake时显式设置构建和安装阶段的RPATH：

cmake .. -DCMAKE_BUILD_RPATH="/home/user/xyz/lib" -DCMAKE_INSTALL_RPATH="/home/user/xyz/lib"

• CMAKE_BUILD_RPATH：针对build目录下的临时产物（比如你提到的测试可执行文件）生效，保证在构建完成后直接运行时能找到库。
• CMAKE_INSTALL_RPATH：针对安装后的程序生效，确保安装到系统或指定目录后能找到依赖库。

2. 让CMake自动追踪自定义库路径 #

如果你是通过find_package或者target_link_libraries来链接这个自定义依赖D，那可以让CMake自动把库所在路径加入RPATH，只需要开启两个参数：

cmake .. -DCMAKE_PREFIX_PATH="/home/user/xyz" -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=ON

• CMAKE_PREFIX_PATH：告诉CMake先去/home/user/xyz下查找依赖库D，确保CMake能正确找到这个库的位置。
• CMAKE_INSTALL_RPATH_USE_LINK_PATH：开启后，CMake会自动把所有链接阶段用到的库的路径都加入RPATH，不管这个路径是不是系统默认路径。

3. 针对单个目标单独配置RPATH #

如果不想给整个项目都添加这个路径，只想给特定的可执行文件或库设置，可以在你的CMakeLists.txt里添加如下配置：

# 替换成你实际的目标名称（比如你的测试可执行文件名）
set_target_properties(your_target_name PROPERTIES
    BUILD_RPATH "/home/user/xyz/lib"
    INSTALL_RPATH "/home/user/xyz/lib"
    INSTALL_RPATH_USE_LINK_PATH ON
)

这种方式更灵活，只会影响你指定的那个目标，不会干扰项目里的其他组件。

额外注意事项 #

在Nix环境下，一些环境变量可能会覆盖CMake的默认设置，所以最好优先通过cmake命令行参数来指定这些RPATH配置，或者在CMakeLists.txt里明确设置，避免被Nix的默认配置覆盖。

备注：内容来源于stack exchange，提问作者Lukasz