如何根据环境变量决定是否构建CMake目标？

问题根源 #

你遇到的问题核心是CMake阶段划分：if这类CMake指令属于配置阶段（运行cmake命令时执行），而add_custom_target的COMMAND参数是构建阶段（运行make/ninja等时执行）的shell命令，两者不能混用。目标外部的if在配置阶段执行，所以正常；但写在add_custom_target内部时，CMake会把它当成构建命令的一部分，自然无法识别。

解决方案 #

以下是三种可行的实现方式，按需选择：

方案1：配置阶段决定是否添加生成命令

如果不需要每次构建动态切换（仅在配置时通过环境变量决定后续构建行为），可以直接在配置阶段用if包裹COMMAND：

add_custom_target(gen_messages)
if(NOT DEFINED ENV{NOGEN})
    add_custom_command(TARGET gen_messages POST_BUILD
        COMMAND echo "Generating messages"
        COMMAND # 你的其他生成命令
    )
endif()

注意：如果后续要切换NOGEN状态，需要重新运行cmake配置（比如NOGEN=true cmake ..）才能生效。

方案2：构建阶段用shell条件判断（跨平台需适配）

直接在COMMAND中使用shell的条件语法，让构建时的shell来判断环境变量：

• Unix/Linux/macOS（bash语法）：

add_custom_target(gen_messages
    COMMAND bash -c "if [ -z \"$NOGEN\" ]; then echo 'Generating messages'; <你的生成命令>; fi"
)

• Windows（cmd语法）：

add_custom_target(gen_messages
    COMMAND cmd /c "if not defined NOGEN (echo Generating messages && <你的生成命令>)"
)

优点：无需重新配置，每次构建都能通过NOGEN=true make动态控制；缺点：shell语法跨平台需要分别适配。

方案3：用CMake脚本实现跨平台条件控制

写一个独立的CMake脚本处理生成逻辑，在自定义目标中调用该脚本，既可以用CMake的语法写条件，又能跨平台：

1. 创建gen_messages.cmake脚本：

if(NOT DEFINED ENV{NOGEN})
    message(STATUS "Generating messages")
    execute_process(COMMAND <你的生成命令1>)
    execute_process(COMMAND <你的生成命令2>)
    # 其他生成步骤
endif()

2. 在主CMakeLists.txt中调用该脚本：

add_custom_target(gen_messages
    COMMAND ${CMAKE_COMMAND} -P ${CMAKE_CURRENT_SOURCE_DIR}/gen_messages.cmake
)

优点：完全用CMake语法，跨平台无需适配；每次构建都会检查当时的NOGEN环境变量，动态决定是否生成代码。

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