CMake 015日志级别全解析一、日志级别总览从高到低二、最高危FATAL 级别 —— 进程直接终止核心行为示例代码执行结果三、次严重SEND_ERROR 级别 —— 构建停止进程继续核心行为示例代码执行结果四、警告级别WARNING—— 提示风险不阻断构建核心行为示例代码执行结果五、普通提示NOTICE—— 无格式纯信息输出核心行为示例代码六、用户状态STATUS—— 带前缀的友好提示核心行为示例代码执行结果七、详细信息VERBOSE—— 默认隐藏的扩展日志核心行为开启方式示例代码八、开发者调试DEBUG TRACE—— 底层跟踪专用核心行为开启方式示例代码九、核心机制STDOUT 与 STDERR 分流1️⃣ 标准输出 STDOUT可重定向到文件2️⃣ 标准错误输出 STDERR控制台默认展示十、终极技巧全量日志重定向到文件十一、级别速查表记忆版总结在 CMake 工程化开发中日志输出是调试、定位问题、感知构建状态的核心手段。CMake 提供了一套从严重错误到跟踪调试的完整日志级别体系遵循「从高到低」的使用原则不同级别对应不同行为、输出格式与信息流走向。熟练掌握这套规则能让你的构建脚本更健壮、问题定位更高效。本文将从最致命的FATAL开始逐级拆解每类日志的行为、用法、输出特征并附上可直接运行的代码示例最后讲透标准输出 / 标准错误输出的重定向技巧。一、日志级别总览从高到低CMake 日志优先级从高到低依次为FATAL→ERROR→WARNING→NOTICE→STATUS→VERBOSE→DEBUG→TRACE越高级别的日志对构建流程影响越大越低级别信息量越细、默认越不显示。二、最高危FATAL 级别 —— 进程直接终止FATAL是最高优先级错误一旦触发CMake 进程立即退出后续所有代码完全不执行。核心行为打印错误信息进程直接退出后续逻辑彻底中断属于标准错误输出STDERR示例代码# FATAL 错误触发后直接退出 message(FATAL_ERROR test fatal error) # 这行永远不会被执行 message(after fatal error)执行结果test fatal errorafter fatal error完全不输出CMake 直接终止。关键结论FATAL_ERROR用于不可恢复的致命错误必须确保在安全场景才启用测试时务必注释掉。三、次严重SEND_ERROR 级别 —— 构建停止进程继续SEND_ERROR不会杀死 CMake 进程脚本会继续往下跑但项目构建产物完全不生成。核心行为打印错误信息CMake 进程继续执行停止生成可执行文件 / 库add_executable/add_library失效带文件路径 行号便于定位属于标准错误输出STDERR示例代码# 触发 ERROR不退出但不生成项目 message(SEND_ERROR test send error) # 会继续执行 message(after error) # 项目文件不会生成 add_executable(test_message test_message.cpp)执行结果控制台输出错误与行号after error正常打印build目录无任何可执行文件关键结论SEND_ERROR适合业务逻辑错误但不必终止脚本的场景阻止非法构建但不中断流程。四、警告级别WARNING—— 提示风险不阻断构建WARNING用于非阻断性警告不影响生成、不退出只提醒风险。核心行为打印警告信息带文件路径 行号进程正常执行、项目正常生成属于标准错误输出STDERR示例代码message(WARNING test warning)执行结果CMake Warning at xxx/CMakeLists.txt:xx (message): test warning关键结论WARNING用于潜在问题提示不影响正常构建流程。五、普通提示NOTICE—— 无格式纯信息输出NOTICE是默认普通提示与不带任何参数的message(#34;msg#34;)完全等价。核心行为纯文本输出不带路径 / 行号简洁、通用适合常规提示属于标准错误输出STDERR示例代码message(NOTICE test notice) message(等同于 notice) # 等价写法关键结论NOTICE是最常用的通用日志无多余格式适合流程说明。六、用户状态STATUS—— 带前缀的友好提示STATUS用于输出用户关心的构建状态比NOTICE级别更低自带前缀标识。核心行为输出自带前缀-- test status简洁、清晰适合库编译成功、配置完成等状态属于标准输出STDOUT示例代码message(STATUS test status)执行结果-- test status关键结论STATUS面向使用者展示关键状态不干扰错误信息。七、详细信息VERBOSE—— 默认隐藏的扩展日志VERBOSE是用户级详细信息默认不显示需手动开启日志级别。核心行为默认隐藏自带--前缀属于标准输出STDOUT适合输出详细配置、路径、依赖等信息开启方式cmake-S.-Bbuild --log-levelverbose示例代码message(VERBOSE test verbose)关键结论VERBOSE用于需要时才展示的详细信息避免控制台污染。八、开发者调试DEBUG TRACE—— 底层跟踪专用DEBUG与TRACE是开发者级日志默认不显示用于深度调试。核心行为均自带前缀DEBUG调试信息TRACE路径 / 流程跟踪需指定级别才能显示开启方式# 显示 DEBUGcmake-S.-Bbuild --log-leveldebug# 显示 TRACE最详细cmake-S.-Bbuild --log-leveltrace示例代码message(DEBUG test debug) message(TRACE test trace)九、核心机制STDOUT 与 STDERR 分流CMake 日志严格分为两类信息流1️⃣ 标准输出 STDOUT可重定向到文件STATUSVERBOSEDEBUGTRACE2️⃣ 标准错误输出 STDERR控制台默认展示FATAL_ERRORSEND_ERRORWARNINGNOTICE/ 无参数 message十、终极技巧全量日志重定向到文件在 Windows/Linux 通用把 ** 所有输出STDOUTSTDERR** 写入日志文件cmake-S.-Bbuild --log-leveltracelog.txt21gt; log.txt重定向 STDOUT2gt;amp;1把 STDERR 合并到 STDOUT一起写入文件打开log.txt即可看到完整构建日志便于复盘与排查。十一、级别速查表记忆版级别行为输出信息流适用场景FATAL进程退出错误STDERR致命错误ERROR不生成项目错误 行号STDERR阻断构建WARNING正常构建警告 行号STDERR风险提示NOTICE正常输出纯文本STDERR通用提示STATUS状态输出--前缀STDOUT用户状态VERBOSE默认隐藏--前缀STDOUT详细信息DEBUG默认隐藏前缀STDOUT调试TRACE默认隐藏前缀STDOUT跟踪总结CMake 日志体系层级清晰、行为明确、分流严谨高级别控制流程低级别提供信息FATAL/ERROR保障构建安全STATUS/VERBOSE提升用户体验DEBUG/TRACE支撑深度调试输出重定向让日志可沉淀、可分析把这套规则用到项目里你的 CMake 脚本会更规范、更易维护、更易排查问题。
CMake 015：日志级别全解析
CMake 015日志级别全解析一、日志级别总览从高到低二、最高危FATAL 级别 —— 进程直接终止核心行为示例代码执行结果三、次严重SEND_ERROR 级别 —— 构建停止进程继续核心行为示例代码执行结果四、警告级别WARNING—— 提示风险不阻断构建核心行为示例代码执行结果五、普通提示NOTICE—— 无格式纯信息输出核心行为示例代码六、用户状态STATUS—— 带前缀的友好提示核心行为示例代码执行结果七、详细信息VERBOSE—— 默认隐藏的扩展日志核心行为开启方式示例代码八、开发者调试DEBUG TRACE—— 底层跟踪专用核心行为开启方式示例代码九、核心机制STDOUT 与 STDERR 分流1️⃣ 标准输出 STDOUT可重定向到文件2️⃣ 标准错误输出 STDERR控制台默认展示十、终极技巧全量日志重定向到文件十一、级别速查表记忆版总结在 CMake 工程化开发中日志输出是调试、定位问题、感知构建状态的核心手段。CMake 提供了一套从严重错误到跟踪调试的完整日志级别体系遵循「从高到低」的使用原则不同级别对应不同行为、输出格式与信息流走向。熟练掌握这套规则能让你的构建脚本更健壮、问题定位更高效。本文将从最致命的FATAL开始逐级拆解每类日志的行为、用法、输出特征并附上可直接运行的代码示例最后讲透标准输出 / 标准错误输出的重定向技巧。一、日志级别总览从高到低CMake 日志优先级从高到低依次为FATAL→ERROR→WARNING→NOTICE→STATUS→VERBOSE→DEBUG→TRACE越高级别的日志对构建流程影响越大越低级别信息量越细、默认越不显示。二、最高危FATAL 级别 —— 进程直接终止FATAL是最高优先级错误一旦触发CMake 进程立即退出后续所有代码完全不执行。核心行为打印错误信息进程直接退出后续逻辑彻底中断属于标准错误输出STDERR示例代码# FATAL 错误触发后直接退出 message(FATAL_ERROR test fatal error) # 这行永远不会被执行 message(after fatal error)执行结果test fatal errorafter fatal error完全不输出CMake 直接终止。关键结论FATAL_ERROR用于不可恢复的致命错误必须确保在安全场景才启用测试时务必注释掉。三、次严重SEND_ERROR 级别 —— 构建停止进程继续SEND_ERROR不会杀死 CMake 进程脚本会继续往下跑但项目构建产物完全不生成。核心行为打印错误信息CMake 进程继续执行停止生成可执行文件 / 库add_executable/add_library失效带文件路径 行号便于定位属于标准错误输出STDERR示例代码# 触发 ERROR不退出但不生成项目 message(SEND_ERROR test send error) # 会继续执行 message(after error) # 项目文件不会生成 add_executable(test_message test_message.cpp)执行结果控制台输出错误与行号after error正常打印build目录无任何可执行文件关键结论SEND_ERROR适合业务逻辑错误但不必终止脚本的场景阻止非法构建但不中断流程。四、警告级别WARNING—— 提示风险不阻断构建WARNING用于非阻断性警告不影响生成、不退出只提醒风险。核心行为打印警告信息带文件路径 行号进程正常执行、项目正常生成属于标准错误输出STDERR示例代码message(WARNING test warning)执行结果CMake Warning at xxx/CMakeLists.txt:xx (message): test warning关键结论WARNING用于潜在问题提示不影响正常构建流程。五、普通提示NOTICE—— 无格式纯信息输出NOTICE是默认普通提示与不带任何参数的message(#34;msg#34;)完全等价。核心行为纯文本输出不带路径 / 行号简洁、通用适合常规提示属于标准错误输出STDERR示例代码message(NOTICE test notice) message(等同于 notice) # 等价写法关键结论NOTICE是最常用的通用日志无多余格式适合流程说明。六、用户状态STATUS—— 带前缀的友好提示STATUS用于输出用户关心的构建状态比NOTICE级别更低自带前缀标识。核心行为输出自带前缀-- test status简洁、清晰适合库编译成功、配置完成等状态属于标准输出STDOUT示例代码message(STATUS test status)执行结果-- test status关键结论STATUS面向使用者展示关键状态不干扰错误信息。七、详细信息VERBOSE—— 默认隐藏的扩展日志VERBOSE是用户级详细信息默认不显示需手动开启日志级别。核心行为默认隐藏自带--前缀属于标准输出STDOUT适合输出详细配置、路径、依赖等信息开启方式cmake-S.-Bbuild --log-levelverbose示例代码message(VERBOSE test verbose)关键结论VERBOSE用于需要时才展示的详细信息避免控制台污染。八、开发者调试DEBUG TRACE—— 底层跟踪专用DEBUG与TRACE是开发者级日志默认不显示用于深度调试。核心行为均自带前缀DEBUG调试信息TRACE路径 / 流程跟踪需指定级别才能显示开启方式# 显示 DEBUGcmake-S.-Bbuild --log-leveldebug# 显示 TRACE最详细cmake-S.-Bbuild --log-leveltrace示例代码message(DEBUG test debug) message(TRACE test trace)九、核心机制STDOUT 与 STDERR 分流CMake 日志严格分为两类信息流1️⃣ 标准输出 STDOUT可重定向到文件STATUSVERBOSEDEBUGTRACE2️⃣ 标准错误输出 STDERR控制台默认展示FATAL_ERRORSEND_ERRORWARNINGNOTICE/ 无参数 message十、终极技巧全量日志重定向到文件在 Windows/Linux 通用把 ** 所有输出STDOUTSTDERR** 写入日志文件cmake-S.-Bbuild --log-leveltracelog.txt21gt; log.txt重定向 STDOUT2gt;amp;1把 STDERR 合并到 STDOUT一起写入文件打开log.txt即可看到完整构建日志便于复盘与排查。十一、级别速查表记忆版级别行为输出信息流适用场景FATAL进程退出错误STDERR致命错误ERROR不生成项目错误 行号STDERR阻断构建WARNING正常构建警告 行号STDERR风险提示NOTICE正常输出纯文本STDERR通用提示STATUS状态输出--前缀STDOUT用户状态VERBOSE默认隐藏--前缀STDOUT详细信息DEBUG默认隐藏前缀STDOUT调试TRACE默认隐藏前缀STDOUT跟踪总结CMake 日志体系层级清晰、行为明确、分流严谨高级别控制流程低级别提供信息FATAL/ERROR保障构建安全STATUS/VERBOSE提升用户体验DEBUG/TRACE支撑深度调试输出重定向让日志可沉淀、可分析把这套规则用到项目里你的 CMake 脚本会更规范、更易维护、更易排查问题。
