message()是cmake调试核心手段，需掌握变量打印、级别区分（status/warning/fatal_error）、复杂变量展开、作用域检查及输出时机控制，避免因未定义变量或缓存跳过导致误判。
调试CMake脚本时需要实时查看变量值、条件判断结果和执行路径，message()是最直接有效的输出手段，但必须掌握不同级别、格式和触发时机的用法，否则可能看不到输出或误判状态。
基础输出：用message()打印字符串和变量
在CMakeLists.txt任意位置插入message("Hello")即可输出纯文本；要打印变量，用${VAR_NAME}语法包裹，例如message("Build type: ${CMAKE_BUILD_TYPE}")。
变量未定义时会显示为空字符串，不会报错也不会提示——这容易掩盖逻辑错误，【务必先用if(DEFINED VAR)确认变量存在再打印】。
这一步操作起来很简单，直接把message()加到set()或find_package()之后就能看到赋值结果。
区分输出级别：STATUS/WARNING/FATAL_ERROR的实际效果
message(STATUS "Configuring for Windows") 会在配置阶段以浅蓝色前缀显示，不中断流程；message(WARNING "Boost not found") 显示黄色警告但继续执行；message(FATAL_ERROR "CUDA required") 立即终止配置并退出。
STATUS消息默认被IDE（如CLion、VS Code CMake Tools）折叠，需手动展开才能看到；而FATAL_ERROR会强制弹出错误面板，适合做硬性依赖检查。
WARNING和FATAL_ERROR都会在终端中高亮显示，STATUS则混在普通日志里——调试时优先用STATUS，验证逻辑后再升级为WARNING。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
打印复杂变量内容：列表、缓存项和作用域变量
方法一：展开列表变量
使用message("${MY_LIST}")只能输出第一个元素，正确做法是用foreach循环逐个打印：
foreach(item ${MY_LIST})
message(STATUS "Item: ${item}")
endforeach()
方法二：查看缓存变量真实值
message("CMAKE_INSTALL_PREFIX=${CMAKE_INSTALL_PREFIX}") 可能显示初始值而非用户传入值，应改用message(CACHE "CMAKE_INSTALL_PREFIX")，它会同时显示类型、值和描述。
方法三：检查当前作用域变量
message("Current scope vars:")
get_cmake_property(_vars VARIABLES)
foreach(_var ${_vars})
if(NOT _var MATCHES "^CMAKE_")
message(STATUS "${_var}=${${_var}}")
endif()
endforeach()
注意：get_cmake_property(VARIABLES)获取的是全局+当前目录作用域的变量，不包括函数内部局部变量——若在function里调试，必须用message()放在函数体内部输出。
控制输出时机：避免被缓存跳过或重复触发
第一步：确保message()不被CMake缓存机制绕过
CMake在第二次运行时可能跳过某些逻辑块（如if(NOT DEFINED ...)），导致message()没执行。解决方法是在message前加一句set(FORCE_PRINT ON CACHE INTERNAL "")强制刷新上下文。
第二步：给关键节点加唯一标识符
message(STATUS "[STEP-CONFIGURE-START] CMAKE_SOURCE_DIR=${CMAKE_SOURCE_DIR}")，这样在海量日志中能快速定位目标段落。
第三步：用if(CMAKE_VERBOSE_MAKEFILE)包裹高频调试输出
if(CMAKE_VERBOSE_MAKEFILE)
message(STATUS "Link libraries: ${LINK_LIBS}")
endif()
避免正式构建时刷屏，又保留开启详细日志时的可见性。
