CMake里的message命令怎么用？-C++-PHP中文网

最稳妥用 message(status "msg") 输出普通信息，避免无模式调用；变量需 ${} 展开；多参数自动拼接；换行优先用多条 message；warning 不中断构建，send_error 延迟报错，fatal_error 立即终止；调试时打包输出相关变量；message 仅配置期执行，非日志系统。

cmake里的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，结果用户只看到最后一条，前面的问题被掩盖。应该先收集问题，最后统一报错：

C++

"空空如也"

下载

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() 时