cmake_minimum_required报错本质是策略机制触发强制终止，而非单纯版本校验；它既验证cmake版本是否达标，更关键的是激活对应版本的策略集（如cmp0115），版本不匹配时连策略加载都无法完成，故必须报错而非警告。
CMake版本不兼容报错，本质不是“版本低了就得升级”，而是cmake_minimum_required触发了策略切换和语法校验双重机制——直接硬升CMake可能让旧项目反而构建失败。
为什么cmake_minimum_required会报错而不是警告？
它不只是检查版本数字，更关键的是激活对应版本的策略集（如CMP0120）。比如你写cmake_minimum_required(VERSION 3.20)，但当前是3.16，CMake连策略加载都跳不过去，直接终止。错误信息里那句“CMake 3.20 or higher is required”后面往往跟着实际出问题的策略编号（如CMP0115），这才是根因。
- 策略变更比语法变更更隐蔽：同一行
find_package(OpenCV REQUIRED)在3.15能过，在3.20可能因CMP0074被拒绝，除非显式加CONFIG或NO_MODULE - 错误日志里如果出现
Compatibility with CMake ，说明项目里某个子模块（如OpenCV自带的<code>OpenCVGenPkgconfig.cmake）还在用已弃用的写法，不是你主CMakeLists.txt的问题 - Android NDK场景下，
ndk version '25.1.8937393' is incompatible with cmake 3.22.1这类报错，其实是AGP（Android Gradle Plugin）强制绑定了三方组件兼容矩阵，不能只看CMake单版本
不改CMake版本，怎么让老项目在新环境跑起来？
核心思路是“降级策略”，而非降级CMake本身。在cmake_minimum_required之后立即用cmake_policy覆盖具体策略行为：
- 先查出报错对应的策略ID：运行
cmake --help-policy CMPxxxx（比如CMP0074），看它描述的是哪类行为变更 - 在
cmake_minimum_required后加cmake_policy(SET CMP0074 NEW)或cmake_policy(SET CMP0074 OLD)，根据项目实际需要选OLD回退到旧逻辑 - 对多个策略批量处理，可用
cmake_policy(VERSION 3.15)——这行会把所有3.15引入的策略设为OLD，但注意它不会影响3.15之后新增的策略 - 避免滥用
cmake_policy(VERSION)：如果你项目明确依赖3.20的新特性（如FetchContent_Declare的TRANSITIVE参数），设成3.15会导致功能缺失
升级CMake时最容易踩的坑
系统包管理器装的cmake3和手动装的cmake常共存，PATH顺序一乱就调用错版本：
- 执行
which cmake和cmake --version必须输出一致；若which返回/usr/bin/cmake3但--version显示3.28，说明有符号链接污染 - RHEL/CentOS系默认只有
cmake3命令，需手动建软链：sudo ln -sf /usr/bin/cmake3 /usr/bin/cmake，否则Flutter或Android Studio调用cmake会失败 - Docker镜像里用
apt install cmake在Ubuntu 22.04装的是3.22，但某些基础镜像（如debian:slim）压根没CMake，得自己curl二进制包解压并ln -s - Windows上Android Studio内置CMake路径（
android-sdk/cmake/）和系统PATH里的CMake冲突时，优先级由Gradle的externalNativeBuild配置决定，不是环境变量说了算
真正麻烦的从来不是版本数字本身，而是策略开关与真实代码行为之间的耦合关系——看到报错先别急着升级，打开终端跑cmake --help-policy查ID，比盲目重装快得多。
