CMake为不同可执行文件配置专属预编译宏的问题求助

问题根源 #

你推测的完全正确：当前仅给可执行文件设置SCENARIO_VERSION宏，但库目标（foo、baz）编译时使用的是main.hpp中默认的SCENARIO_VERSION=0，导致可执行文件中调用的是版本1的函数声明，而库提供的是版本0的函数实现，符号不匹配引发链接错误。

符合现代CMake标准的解决方案 #

核心思路是：为每个场景创建独立的库目标，确保库与对应场景的可执行文件使用相同的宏值编译。

1. 修改src/CMakeLists.txt，封装库创建逻辑

将库的创建逻辑封装为CMake函数，方便为不同场景生成带宏配置的库实例：

# 定义创建场景专属库的函数
function(add_scenario_library scenario_name scenario_version)
    # 创建静态库目标（根据需求可改为SHARED）
    add_library(${scenario_name}_lib STATIC
        foo/foo.cpp
        foo/foo.hpp
        baz/baz.cpp
        baz/baz.hpp
        main.hpp
    )

    # 设置库的编译宏（PUBLIC确保链接该库的可执行文件自动继承宏）
    target_compile_definitions(${scenario_name}_lib PUBLIC
        SCENARIO_VERSION=${scenario_version}
    )

    # 暴露头文件路径，让可执行文件能正确引用
    target_include_directories(${scenario_name}_lib PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}
    )
endfunction()

2. 根目录CMakeLists.txt调整

确保先加载src目录的函数定义，再添加场景子目录：

cmake_minimum_required(VERSION 3.16)
project(my_project)

# 加载src目录的库创建函数
add_subdirectory(src)

# 添加各个场景的可执行文件
add_subdirectory(app/scenario1)
add_subdirectory(app/scenario2)

3. 场景目录CMakeLists.txt配置

以scenario1为例，修改app/scenario1/CMakeLists.txt：

# 创建scenario1专属的库，指定宏值为1
add_scenario_library(scenario1 1)

# 创建场景可执行文件
add_executable(scenario1 scenario1.cpp)

# 链接专属库（自动继承宏定义，无需单独给可执行文件设宏）
target_link_libraries(scenario1 PRIVATE scenario1_lib)

同理，修改app/scenario2/CMakeLists.txt，指定对应的宏值（比如0）：

add_scenario_library(scenario2 0)
add_executable(scenario2 scenario2.cpp)
target_link_libraries(scenario2 PRIVATE scenario2_lib)

关键说明 #

• 采用基于目标的配置：完全避免全局宏定义，每个场景的库和可执行文件形成独立的编译单元，宏值隔离，不会互相干扰。
• PUBLIC关键字的作用：确保库的宏定义会传递给所有链接它的目标（即可执行文件），无需在可执行文件中重复设置宏，保证头文件中宏的一致性。

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