CMake中的AUTHOR_WARNING消息是什么？与WARNING有何区别？

不得不说v3.11.1的文档确实把这俩的差异写得太模糊了，但从CMake的设计初衷和实际使用场景来看，它们的定位其实很清晰：

• 目标受众完全不同：

  • WARNING是给所有使用这个CMake脚本的构建者看的，比如项目的使用者、运维人员，提示的是可能影响构建结果、兼容性的通用问题，属于面向用户的警告。
  • AUTHOR_WARNING则是写给CMake脚本的编写者（也就是你我这类开发者）的，用来标记脚本里的潜在逻辑漏洞、不符合最佳实践的写法，或者是仅在开发阶段需要关注的细节，属于面向开发者的内部提示。

• 显示逻辑有差异：

  • WARNING默认会直接显示给所有构建者，除非用户通过特定变量（比如CMAKE_WARN_DEPRECATED）主动关闭相关警告。
  • AUTHOR_WARNING默认是隐藏的，只有当开发者开启了CMAKE_DEVELOPER_WARNINGS选项，或者使用--warn-dev命令行参数时才会显示，普通用户构建项目时完全看不到这类提示，避免不必要的干扰。

• 举两个实际使用的例子更清楚：

  • 如果你想提醒构建者“当前编译器版本过低，可能导致功能缺失”，就用WARNING：

    message(WARNING "Your Clang version is ${CMAKE_CXX_COMPILER_VERSION}, which doesn't support C++20 features we use.")
    

  • 如果你是脚本开发者，想给自己留个待优化的标记“这里的依赖判断逻辑可能在跨平台场景下出问题”，就用AUTHOR_WARNING：

    message(AUTHOR_WARNING "Dependency check logic doesn't handle macOS framework paths yet - TODO: add platform-specific handling.")
    

说白了就是：WARNING对外，AUTHOR_WARNING对内，后者默认藏起来，只给开发者自己看。

内容的提问来源于stack exchange，提问作者Xunie