Qt Creator(CMake)构建设置中自定义编译宏值的实现方法

一、CMakeLists.txt 配置 #

先在CMake脚本里定义可外部传入的变量，根据构建类型适配，同时保证宏定义格式符合C++要求：

# 可选：给Debug/Release设置默认值（若不需要默认值，可直接跳过这部分，强制外部传入）
if(CMAKE_BUILD_TYPE STREQUAL "Debug")
    set(FOO_VALUE "debug_default" CACHE STRING "Value for macro foo")
else()
    set(FOO_VALUE "release_default" CACHE STRING "Value for macro foo")
endif()

# 生成编译定义，转义引号确保C++预处理后得到 #define foo "xxx"
add_compile_definitions(foo=\"${FOO_VALUE}\")

如果不想把任何默认值写进代码仓库，直接改成强制外部传入的写法：

# 仅声明变量，等待外部传入值
set(FOO_VALUE "" CACHE STRING "Value for macro foo")
# 可选：强制检查变量是否被设置，避免编译出错
if(NOT FOO_VALUE)
    message(FATAL_ERROR "FOO_VALUE must be set via Qt Creator or command line")
endif()

add_compile_definitions(foo=\"${FOO_VALUE}\")

二、Qt Creator 构建设置（传入敏感值） #

1. 打开项目的构建设置（左侧边栏点「项目」图标，选择对应的构建套件）
2. 切换到CMake选项卡，找到「CMake配置」区域
3. 点击「添加」按钮，分模式设置键值对：
   • Debug模式：
     键：FOO_VALUE
     值：你的Debug专用字符串（比如debug_secret_123，不需要加引号，CMake会自动处理成带引号的宏）
   • Release模式：
     切换到Release构建模式，同样添加FOO_VALUE键，值填你的Release专用字符串（比如release_secret_456）

这些配置会存在本地的CMakeUserPresets.json文件里，把这个文件加入.gitignore，就能避免敏感值提交到代码仓库。

三、验证效果 #

在C++代码里直接用foo宏即可：

#include <iostream>

int main() {
    std::cout << foo << std::endl; // Debug输出debug_secret_123，Release输出release_secret_456
    return 0;
}

内容的提问来源于stack exchange，提问作者Paul Masri-Stone