【CMake】CMake 与 C++ 协同：条件配置机制及控制台控制实例解析

最新推荐文章于 2025-08-13 23:15:00 发布

原创最新推荐文章于 2025-08-13 23:15:00 发布 · 312 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#c++

CMake 与 C++ 协同：条件配置机制及控制台控制实例解析

1. CMake中定义变量并传递编译宏

# 设置是否显示控制台（CMake变量定义）
set(ENABLE_CONSOLE OFF)             # 布尔变量（用于条件判断）

# 将CMake变量传递给目标程序（需在add_executable之后调用）
if(ENABLE_CONSOLE)
    # 当ENABLE_CONSOLE为ON时，向softRenderer目标定义宏ENABLE_CONSOLE
    target_compile_definitions(softRenderer PRIVATE ENABLE_CONSOLE)
endif()

核心逻辑：通过set定义CMake变量作为“开关”，再用target_compile_definitions条件性地向C++目标传递宏，实现“构建配置”到“代码逻辑”的映射。
注意点：target_compile_definitions必须在add_executable(softRenderer ...)之后，因为它依赖于目标已被创建（“先定义目标，再配置属性”）。

2. C++中使用宏实现条件编译

// 根据CMake定义的宏选择链接器子系统
#ifdef ENABLE_CONSOLE
    // 启用控制台（调试时用）
    #pragma comment(linker, "/subsystem:console /entry:wWinMainCRTStartup")
#else
    // 禁用控制台（发布时用）
    #pragma comment(linker, "/subsystem:windows /entry:wWinMainCRTStartup")
#endif

核心逻辑：C++通过#ifdef判断宏是否存在，进而执行不同分支（控制Windows链接器的子系统和入口点）。
作用：区分“调试模式”（显示控制台用于日志输出）和“发布模式”（隐藏控制台，更简洁）。

举一反三：扩展知识点

1. CMake传递配置的其他方式

除了target_compile_definitions，还有更多灵活的配置传递方式：

configure_file：通过模板生成头文件，适合传递路径、版本号等（比宏更适合字符串）：

# CMakeLists.txt
set(APP_VERSION "2.1.0")
configure_file(config.h.in config.h)  # 用模板生成config.h

// config.h.in（模板）
#define APP_VERSION "@APP_VERSION@"

// C++中使用
#include "config.h"
std::cout << "版本：" << APP_VERSION << std::endl;

target_compile_options：传递编译选项（如-O3优化、-Werror警告）。

2. 跨平台的条件编译

Windows用链接器选项控制控制台，其他平台机制不同，可通过宏区分：

#ifdef _WIN32
    // Windows控制台控制（如示例代码）
#elif defined(__linux__)
    // Linux默认绑定控制台，隐藏需用后台运行（nohup ./程序 &）
#elif defined(__APPLE__)
    // macOS类似Linux，可通过Info.plist配置
#endif