最稳妥用 message(STATUS "msg") 输出普通信息，避免无模式调用；变量需 ${} 展开；多参数自动拼接；换行优先用多条 message；WARNING 不中断构建，SEND_ERROR 延迟报错，FATAL_ERROR 立即终止；调试时打包输出相关变量；message 仅配置期执行，非日志系统。
message() 输出普通信息时用 STATUS 最稳妥
不加任何模式的 message("hello") 会走默认路径，但行为不稳定——某些 IDE（如 VS 或 CLion）可能折叠或忽略它；而显式写 message(STATUS "hello") 能确保被识别为状态消息，终端里带 -- 前缀，且不会被静默丢弃。
常见错误是直接拼接变量却忘了加 ${}：比如 message(STATUS "Build type: CMAKE_BUILD_TYPE") 会原样输出字符串，而不是变量值。正确写法是 message(STATUS "Build type: ${CMAKE_BUILD_TYPE}")。
- 多个字符串参数会被自动连成一个，
message(STATUS "Found" " " "OpenSSL")等价于message(STATUS "Found OpenSSL") - 换行要用
\n，但仅在支持转义的 CMake 版本（≥3.18）中生效；更兼容的做法是拆成多条message() - 不要依赖
message()的输出做逻辑判断——它纯属调试辅助，不能触发条件分支
WARNING 和 SEND_ERROR 的行为差异很关键
message(WARNING "deprecated option used") 只是提醒，构建照常进行；而 message(SEND_ERROR "missing dependency") 会让 cmake .. 最终失败退出（退出码非零），但 CMake 会先把当前 CMakeLists.txt 剩余部分跑完再报错——这意味着你可能看到多个 SEND_ERROR 连续输出，但只报最后一个。
典型误用：在循环里对每个未找到的库都发 SEND_ERROR，结果用户只看到最后一条，前面的问题被掩盖。应该先收集问题，最后统一报错：
if(NOT OpenSSL_FOUND AND NOT ZLIB_FOUND) message(SEND_ERROR "Required libraries missing: OpenSSL, ZLIB") endif()
-
FATAL_ERROR是真·立即终止：遇到就停，后续代码完全不执行，适合检查强制前提（如最低 CMake 版本） -
AUTHOR_WARNING默认被抑制，除非你明确设set(CMAKE_SUPPRESS_DEVELOPER_WARNINGS OFF)，否则开发者写的提示根本不会出现 -
DEPRECATION的行为由CMAKE_WARN_DEPRECATED或CMAKE_ERROR_DEPRECATED控制，不是独立开关
调试变量值时，别只打一个 message()
查 find_package(OpenSSL) 为什么失败，只写 message(${OpenSSL_INCLUDE_DIRS}) 得到空输出，你还是不知道是没找到、路径不对，还是变量名拼错了。得组合输出：
message(STATUS "=== OpenSSL debug ===")
message(STATUS "OpenSSL_FOUND: ${OpenSSL_FOUND}")
message(STATUS "OpenSSL_INCLUDE_DIRS: ${OpenSSL_INCLUDE_DIRS}")
message(STATUS "OpenSSL_LIBRARIES: ${OpenSSL_LIBRARIES}")
message(STATUS "CMAKE_PREFIX_PATH: ${CMAKE_PREFIX_PATH}")- 优先输出布尔型变量（如
XXX_FOUND），它是依赖是否命中的第一信号 - 把相关变量打包输出，避免来回改
CMakeLists.txt重试 - 路径类变量建议补一句
message(STATUS "CMAKE_CURRENT_LIST_DIR: ${CMAKE_CURRENT_LIST_DIR}")，确认当前作用域
message() 不是日志系统，别滥用
它只在 CMake 配置阶段（即运行 cmake .. 时）执行，不会出现在 make 或 ninja 构建过程中。有人想用它打印编译进度，那是徒劳的。
性能上，大量 message() 不影响构建速度，但会污染输出流——尤其在 CI 环境里，几百行 STATUS 会让关键错误被刷屏淹没。
- 上线前删掉所有临时
message()，或用if(CMAKE_BUILD_TYPE STREQUAL "Debug")包一层 - 别用它替代
option()或set(... CACHE)做用户配置，它的输出不可交互 - 最易被忽略的一点：message() 的输出顺序不严格对应代码顺序——CMake 内部有缓存和延迟刷新机制，尤其是跨目录
add_subdirectory()时
