CMakeLists.txt顶部加cmake_minimum_required是否为最佳实践？

首先直接给结论：

• 在任意CMakeLists.txt（包括仅做子目录引入的顶层脚本）顶部添加cmake_minimum_required(VERSION ...)是完全安全、且被官方明确要求的标准规范做法，不存在过度使用的问题。
• 你描述的“顶层仅通过add_subdirectory引入子项目”的场景下，绝对不能省略顶层的cmake_minimum_required声明，不存在“子项目写了就可以替代顶层”的说法。

核心原因说明 #

很多初学者对这个命令的认知存在偏差，它的作用不只是“检查当前CMake版本是否满足要求”，还承担了两个关键的全局配置作用：

1. 隐式配置策略集：CMake的不同版本会调整各类命令的默认行为（比如目标属性传递、安装规则逻辑、编译器检测逻辑等），这些行为调整通过「策略（Policy）」机制控制。调用cmake_minimum_required(VERSION x.y)时，CMake会自动把当前脚本作用域及所有下级子目录作用域的策略默认值，设置为x.y版本对应的行为，避免新旧版本行为不兼容导致的诡异构建错误。
2. 消除默认警告：CMake 3.19及之后的所有版本，只要检测到入口脚本（也就是你运行cmake命令时指定的源码目录下的顶层CMakeLists.txt）没有写cmake_minimum_required声明，就会直接抛出开发者警告，提示项目未明确声明兼容的CMake版本。

为什么仅做子目录引入的顶层脚本也不能省略 #

子项目CMakeLists.txt里写的cmake_minimum_required仅能覆盖子目录自身的作用域，无法向上影响顶层作用域的配置：

• 如果顶层缺了该声明，顶层作用域会默认使用CMake 2.4版本的极旧兼容策略，哪怕所有子项目都正确配置了版本要求，顶层作用域执行add_subdirectory等全局命令时仍然会走旧逻辑，很容易出现无迹可寻的构建bug。
• 顶层声明的版本是整个项目对外的兼容承诺，你需要把它设置为所有子项目要求的最低CMake版本的最大值，这样用户运行构建时会在入口第一时间得到版本不兼容的提示，而不是解析到一半在某个子项目里突然报错，构建体验更好。
• 这是工业界所有CMake项目的通用约定：从顶层入口，到每个支持独立构建的子模块，CMakeLists.txt的第一行有效代码（注释除外）一定是cmake_minimum_required声明。

正确写法示例 #

如果你的所有子项目中要求的最高CMake版本是3.16，顶层CMakeLists.txt按如下结构写即可：

# 顶层CMakeLists.txt 第一行有效代码即声明最低版本
cmake_minimum_required(VERSION 3.16)
project(WholeProject LANGUAGES C CXX)

add_subdirectory(subproject_1)
# 其他子项目引入
add_subdirectory(subproject_n)

子项目可以根据自身兼容情况写更低的版本要求，比如子项目兼容CMake 3.10就写cmake_minimum_required(VERSION 3.10)，和顶层声明不会冲突。

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