cmake_minimum_required是cmake构建的硬性门槛，必须位于顶层cmakelists.txt首行，用于强制校验最低版本并初始化策略；版本格式为major.minor[.patch[.tweak]]，推荐显式添加fatal_error以确保兼容性。
当你打开一个CMakeLists.txt文件，第一行看到cmake_minimum_required(VERSION 3.14)，它不是注释、不是可选配置，而是整个构建流程的硬性门槛——版本不达标，CMake直接报错退出，连project()都不会执行。
cmake_minimum_required的本质作用
它强制校验当前运行的CMake二进制版本是否满足项目最低要求。低于指定版本时，CMake立即终止解析，不生成任何构建文件，避免因语法或策略差异导致后续不可预知的错误。
这一步操作起来很简单，直接把cmake_minimum_required(VERSION x.y)写在CMakeLists.txt最开头就行。
【必须是顶层CMakeLists.txt的第一条可执行命令，注释可以放在它前面，但不能有任何其他命令】
版本号格式与填写规则
版本号必须符合major.minor[.patch[.tweak]]格式，例如3.10、3.24.2、3.28.1.0。其中主版本号和次版本号必填，补丁号和微调号可省略。
你可以在终端运行cmake --version确认本地版本，确保填写的
不要写成cmake_minimum_required(VERSION 3.10 3.15)这种错误形式——空格分隔的双版本不是合法语法，CMake会报Parse error in command line argument: 3.15。
带FATAL_ERROR参数的写法
方法一：显式添加FATAL_ERROR
在VERSION后加上FATAL_ERROR，例如cmake_minimum_required(VERSION 3.15 FATAL_ERROR)。这个参数对CMake 3.12以下版本是必需的，否则只会警告而不中断。
方法二：不加FATAL_ERROR（仅限CMake 3.12+）
从CMake 3.12开始，FATAL_ERROR已成为默认行为，省略它效果相同。但为兼容旧环境或明确意图，建议始终带上。
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
策略版本自动绑定机制
第一步：cmake_minimum_required触发后，CMake自动将策略版本（Policy Version）设为所填
第二步：若同时指定[policy_max]（仅CMake 3.12+支持），且policy_max ≥ min，则策略版本取policy_max而非
第三步：策略版本决定CMake如何处理某些有变更行为的旧命令（如CMP0077），影响target_link_libraries等关键行为。
【策略版本 ≠ CMake运行版本，它是独立控制语法兼容性的开关】
常见错误位置与后果
错误一：写在project()之后
CMake允许语法通过，但策略初始化失效，后续project()可能使用错误的默认策略，引发链接失败或编译器警告。
错误二：写在function()内部
该调用只在函数作用域内生效，外部完全无感知，CMAKE_MINIMUM_REQUIRED_VERSION变量不会更新，project()仍按默认策略运行。
错误三：写在子目录CMakeLists.txt中
虽然不会报错，但属于冗余操作——只有顶层CMakeLists.txt中的cmake_minimum_required才起全局作用。
