先说说 CMake 日志到底是个啥

你在写 CMakeLists 时常常会kan到一堆 message 的输出。

其实这就是 CMake 的日志系统。

它和我们平时用的那种日志库有点像，只不过级别geng少，玩起来geng直接。

别担心，我这儿把每个级别dou拆开聊，保证你听完Neng把它们玩转。

这个级别一旦出现，CMake 立马挂掉，后面的所有指令dou不会执行。

相当于你在跑步时踩到坑，一脚踏空直接摔倒。

代码示例：

message

执行到这里整个 configure 过程直接结束。

ERROR 会让 CMake 报错，但不会立刻退出进程。

它会把错误信息打印到 STDERR，然后继续往下跑。

Ru果后面还有生成目标，它们仍然会尝试生成，只是会因为前面的错误而失败。

message

SEND_ERROR 跟 ERROR 类似，也是报错但不终止。

不过它的语义geng倾向于“业务逻辑错误”，比如检查到用户输入的不合法配置。

message

WARNING 则是提醒性质的，不影响构建结果，只是给你敲警钟。

message

这个级别只在开发者打开 CMAKE_SUPPRESS_DEVELOPER_ERRORS=OFF 时才会显示。

平时默认隐藏，专门给库的作者留的提示信息。

CMake 默认的 message 不带任何级别，其实等价于 NOTICE。

它们会在构建日志里以 “--” 前缀出现，适合输出流程说明或关键路径。

# 等价写法
message
message

Status 用来告诉使用者当前进度，比如 “检测到依赖 xxx 成功”。

CMake 自带的hen多内部消息dou是 STATUS 级别，你也Ke以自行调用。

message

默认情况下 VERBOSE 是隐藏的，要想kan见得手动打开日志级别或加 -V 参数。

它会把一些细节操作暴露出来比如每一步 add_subdirectory 的路径。

# 开启详细模式
cmake -S . -B build --log-level=VERBOSE

DEBUG 会打印出变量值、函数调用等调试信息，但同样默认隐藏。

TRACE geng进一步，会把每条 CMake 脚本执行的过程逐行记录下来基本上就是 “跟踪模式”。

# 查kanZui细粒度日志
cmake -S . -B build --log-level=TRACE

FATAL_ERROR → ERROR → SEND_ERROR → WARNING → AUTHOR_WARNING → NOTICE → STATUS → VERBOSE → DEBUG → TRACE

CMake 提供了三个常用方式来调节日志：

-V 相当于把日志级别调到 VERBOSE，适合临时查kan细节。

 build.log 2>&1