如何为CMake构建的C++静态库实现可配置程序数据路径？

核心思路 #

• 让数据文件夹的安装路径完全跟随链接该库的可执行文件的安装目录，无需硬编码固定路径
• 开发阶段自动复制数据到可执行文件的二进制输出目录，方便调试
• 库代码使用相对路径查找数据，跨Windows/Linux兼容

库的CMakeLists.txt修改方案 #

替换原来的install(DIRECTORY)命令，改用动态安装逻辑和开发阶段自动复制：

add_library(MyLibrary STATIC <...>)

target_include_directories(MyLibrary 
    PUBLIC 
        ${CMAKE_CURRENT_SOURCE_DIR}/include)

target_compile_definitions(MyLibrary PUBLIC <...>)

# --------------------------
# 开发阶段：自动复制数据到可执行文件目录（CMake 3.21+）
# --------------------------
if(CMAKE_VERSION VERSION_GREATER_EQUAL 3.21)
    # 为所有链接MyLibrary的可执行目标添加POST_BUILD复制命令
    set_target_properties(MyLibrary PROPERTIES
        INTERFACE_POST_BUILD_COMMAND "${CMAKE_COMMAND} -E copy_directory \"${CMAKE_CURRENT_SOURCE_DIR}/MyData\" \"$<TARGET_FILE_DIR:$<TARGET_NAME>>/MyData\""
    )
else()
    # 兼容旧版本CMake：提供手动调用的函数，使用者可按需添加（可选）
    function(copy_mylibrary_data_to_target target)
        add_custom_command(TARGET ${target} POST_BUILD
            COMMAND ${CMAKE_COMMAND} -E copy_directory
                "${CMAKE_CURRENT_SOURCE_DIR}/MyData"
                "$<TARGET_FILE_DIR:${target}>/MyData"
            COMMENT "Copying MyLibrary data to target directory"
        )
    endfunction()
endif()

# --------------------------
# 安装阶段：自动复制数据到可执行文件的安装目录
# --------------------------
install(CODE "
    foreach(target \${CMAKE_INSTALL_TARGETS})
        # 仅处理可执行目标
        get_target_property(target_type \${target} TYPE)
        if(NOT target_type STREQUAL \"EXECUTABLE\")
            continue()
        endif()
        # 检查目标是否链接了MyLibrary
        get_target_property(linked_libs \${target} LINK_LIBRARIES)
        if(NOT linked_libs OR NOT \"MyLibrary\" IN_LIST linked_libs)
            continue()
        endif()
        # 获取目标的安装目录
        get_target_property(install_dest \${target} INSTALL_DESTINATION)
        if(NOT install_dest)
            set(install_dest \${CMAKE_INSTALL_BINDIR})
        endif()
        set(full_install_dir \${CMAKE_INSTALL_PREFIX}/\${install_dest})
        # 复制数据到安装目录
        message(STATUS \"Installing MyLibrary data to: \${full_install_dir}\")
        file(COPY \"${CMAKE_CURRENT_SOURCE_DIR}/MyData\"
             DESTINATION \"\${full_install_dir}\")
    endforeach()
" COMPONENT Runtime)

库代码的路径处理（跨平台） #

在库的C++代码中，使用相对路径查找数据文件夹，确保运行时无论安装到哪里都能找到：

#include <filesystem>
#include <string>
#include <cstdlib>

namespace fs = std::filesystem;

fs::path get_mylibrary_data_path() {
    // 获取当前可执行文件的绝对路径
    fs::path exe_path;
    #ifdef _WIN32
    wchar_t buffer[MAX_PATH];
    GetModuleFileNameW(nullptr, buffer, MAX_PATH);
    exe_path = fs::canonical(fs::path(buffer)).parent_path();
    #else
    exe_path = fs::canonical(fs::path(std::string(getenv("_")))).parent_path();
    #endif
    return exe_path / "MyData";
}

使用者的使用方式（完全符合需求） #

使用者只需保留原来的四行代码（注意修正拼写错误：target_link_library改为target_link_libraries）：

add_subdirectory(<path-to-my-library>)
add_executable(BigExe <...>)
target_link_libraries(BigExe MyLibrary)
install(TARGETS BigExe)

方案优势 #

• 完全适配Windows/Linux系统，无需针对平台写特殊逻辑
• 使用者无需关心数据文件夹的位置，只需正常安装可执行文件
• 开发阶段自动复制数据，无需手动拷贝即可调试
• 支持使用者自定义可执行文件的安装目录，数据会自动跟随

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