CMake如何确保测试链接构建目录库而非已安装库

我的问题场景与同类问题一致，但和LD_LIBRARY_PATH无关。

项目库的CMake配置 #

使用标准CMake流程构建共享库，简化代码如下：

# Installation directories
include(GNUInstallDirs)

# Build library
add_library(${PROJECT_NAME} SHARED
    ${SRC_FILES}
)

# Definitions
target_compile_definitions(${PROJECT_NAME} PUBLIC ${DEFINITIONS})

# Properties
set_target_properties(${PROJECT_NAME} PROPERTIES
    CXX_STANDARD 20
)

# Compile options
target_compile_options(${PROJECT_NAME} PRIVATE
    -Wall -Wextra -Wpedantic
)

# Include directories
target_include_directories(${PROJECT_NAME} PUBLIC
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
    $<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
)

# System include directories
target_include_directories(${PROJECT_NAME} SYSTEM PUBLIC
    ${SYSTEM_INCLUDE_DIRS}
)

# Link libraries
target_link_libraries(${PROJECT_NAME} PUBLIC
    ${SYSTEM_LIBRARIES}
)

测试程序的CMake配置 #

在测试子目录中构建测试程序并链接上述库，代码如下：

# Build tests
add_executable(${PROJECT_NAME}_tests
    ${TEST_SRC_FILES}
)

# Definitions
target_compile_definitions(${PROJECT_NAME}_tests PUBLIC ${TEST_DEFINITIONS})

# Properties
set_target_properties(${PROJECT_NAME}_tests PROPERTIES
    CXX_STANDARD 20
)

# Compile Options
target_compile_options(${PROJECT_NAME}_tests PRIVATE
    -Wall -Wextra -Wpedantic
)

# Include Directories
target_include_directories(${PROJECT_NAME}_tests PUBLIC
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/../include>
)

# System Include Directories
target_include_directories(${PROJECT_NAME}_tests SYSTEM PUBLIC
    ${TEST_SYSTEM_INCLUDE_DIRS}
)

# Link Libraries
target_link_libraries(${PROJECT_NAME}_tests PUBLIC
    ${PROJECT_NAME}
    ${TEST_SYSTEM_LIBRARIES}
)

# Enable ctest
enable_testing()
add_test(NAME ${PROJECT_NAME}_tests COMMAND ${PROJECT_NAME}_tests)

现象 #

1. 首次构建后，测试程序正常链接构建目录下的库，ldd输出：

libmycoolproject.so => /home/username/src/mycoolproject/build/libmycoolproject.so (0x00007ffd2c8c3000)

用readelf -d查看的RUNPATH为：

0x0000000000000001 (NEEDED)             Shared library: [libmycoolproject.so]
... (more libraries)
0x000000000000001d (RUNPATH)            Library runpath: [/home/username/src/mycoolproject/build:/usr/local/lib:/home/username/src/mycoolproject/build/gtest/lib]

注：依赖的某个系统库位于/usr/local/lib。

2. 执行sudo make install安装库后，ldd显示测试程序链接到已安装库：

libmycoolproject.so => /usr/local/lib/libmycoolproject.so (0x00007ffb480b3000)

即使修改本地代码重新构建，测试程序仍链接已安装库，而非构建目录的库。

已尝试但无效的方法 #

• 在set_target_properties中添加BUILD_RPATH ${CMAKE_BINARY_DIR}
• 向CMAKE_BUILD_RPATH追加路径
• 调整target_link_libraries中的库顺序
• 直接链接${CMAKE_BINARY_DIR}/lib${PROJECT_NAME}.so而非${PROJECT_NAME}

疑问 #

1. 如何确保测试在运行时链接构建目录下的库？
2. 链接顺序与RUNPATH在此处的作用机制是什么？

核心问题分析 #

动态链接器查找共享库的优先级大致为：

1. 程序DT_RUNPATH指定的路径（优先级高于系统默认路径）
2. 系统默认路径（如/usr/local/lib，由/etc/ld.so.conf及缓存控制）

你遇到的问题本质是：执行sudo make install后，系统ldconfig更新了共享库缓存，且CMake在重新构建时可能修改了测试程序的RUNPATH优先级，导致动态链接器优先匹配系统缓存中的已安装库。

有效配置调整方法 #

方法1：使用$ORIGIN构建相对路径的RUNPATH #

在测试程序的set_target_properties中添加：

set_target_properties(${PROJECT_NAME}_tests PROPERTIES
    CXX_STANDARD 20
    BUILD_RPATH_USE_ORIGIN ON
    # 根据你的目录结构调整：比如测试程序在build/tests下，$ORIGIN/..就是build目录
    BUILD_RPATH "$ORIGIN/.."
)

$ORIGIN表示测试程序所在的目录，这样程序会优先从自身目录的相对路径（即构建目录）查找库，完全脱离系统路径的干扰。

方法2：禁用CMake的默认安装RPATH处理 #

在项目根目录的CMakeLists.txt开头添加：

# 禁止CMake为目标添加安装相关的RPATH
set(CMAKE_SKIP_INSTALL_RPATH ON)

此配置会让CMake始终为测试程序使用构建目录的RPATH，不会因为安装操作而覆盖或修改路径。

方法3：强制指定RUNPATH并确保构建目录优先级最高 #

修改测试程序的属性配置：

set_target_properties(${PROJECT_NAME}_tests PROPERTIES
    CXX_STANDARD 20
    # 把构建目录放在最前面，确保动态链接器优先查找
    RUNPATH "${CMAKE_BINARY_DIR}:${CMAKE_INSTALL_PREFIX}/lib:/usr/local/lib"
)

RUNPATH作用机制详解 #

• RUNPATH是程序运行时动态链接器查找共享库的路径列表，优先级高于系统默认路径，但低于LD_LIBRARY_PATH（你无需依赖这个环境变量）。
• 动态链接器会严格按照RUNPATH中的顺序依次查找，找到第一个匹配的库后立即停止。
• 与旧的RPATH不同，RUNPATH仅作用于当前程序的直接依赖，不会被依赖库继承使用。

验证步骤 #

修改配置后重新构建测试程序，执行以下命令验证：

1. 用readelf -d ${PROJECT_NAME}_tests查看RUNPATH，确认构建目录路径位于列表最前端。
2. 用ldd ${PROJECT_NAME}_tests检查库链接路径，确认指向构建目录下的库。

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