拓冰网站定制 
构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载cmake_minimum_required是每个 CMake 项目CMakeLists.txt文件中的第一道守门员命令它声明项目运行所需的最低 CMake 版本并在配置阶段将整个项目的 Policy策略版本一次性设定到位。本篇以 CMake 官方命令文档Help/command/cmake_minimum_required.rst为骨架结合本仓库源码与测试用例深入讲解该命令的完整语法、版本区间语义、Policy 版本机制、历史版本兼容规则及放置位置等工程细节。读完本文你将能正确编写版本声明、理解3.10...3.27这类区间写法的真实含义并掌握在函数作用域、第三方子项目等复杂场景下的规避方案。命令语法与核心作用cmake_minimum_required的完整语法如下cmake_minimum_required(VERSION min[...policy_max] [FATAL_ERROR])该命令做两件事设定项目所需的最低 CMake 版本如果当前运行的 CMake 版本低于min配置过程会立即停止并报错更新 Policy 设置命令隐式调用cmake_policy(VERSION min[...policy_max])将项目政策版本Policy Version设定为指定值从而决定当前版本 CMake 中各项行为策略CMPxxxx默认采用NEW还是OLD行为。min与可选的policy_max都是形如major.minor[.patch[.tweak]]的 CMake 版本号其中...是字面量三个点不是省略号。例如cmake_minimum_required(VERSION 3.10...3.27)表示项目要求 CMake 至少为 3.10且已针对 3.27 及更早版本引入的 Policy 做过适配。...policy_max区间语法是 3.12 版本才引入的文档中标注versionadded:: 3.12旧版本 CMake3.12 之前会把...当作版本号分隔符从而忽略...policy_max部分回退到仅基于min设定 Policy 的旧行为。因此该语法向后兼容。版本校验运行版本过低时发生什么当用户用低于min的 CMake 配置项目时命令会停止处理项目并报告错误。从源码实现看Source/cmCMakeMinimumRequired.cxxCMake 会依次比较主版本号、次版本号、补丁号与 tweak 号四个分量if ((current_major required_major) || (current_major required_major current_minor required_minor) || (current_major required_major current_minor required_minor current_patch required_patch) || (current_major required_major current_minor required_minor current_patch required_patch current_tweak required_tweak)) { // The current version is too low. e CMake version_min or higher is required. You are running version cmVersion::GetCMakeVersion(); status.GetMakefile().IssueMessage(MessageType::FATAL_ERROR, e.str()); cmSystemTools::SetFatalErrorOccurred();未指定的版本分量按 0 处理源码第 82-85 行因此VERSION 3.10等价于3.10.0.0。版本解析使用sscanf要求至少解析出major.minor两个分量否则直接报could not parse VERSION错误Source/cmCMakeMinimumRequired.cxx。当版本过低时用户会看到形如CMake 3.27 or higher is required. You are running version 3.16.3的致命错误信息。命令同时会把min写入CMAKE_MINIMUM_REQUIRED_VERSION变量源码 Source/cmCMakeMinimumRequired.cxx方便脚本在配置过程中查询项目声明的最低版本cmake_minimum_required(VERSION 3.10) message(STATUS Minimum required version: ${CMAKE_MINIMUM_REQUIRED_VERSION}) # 输出Minimum required version: 3.10测试目录 Tests/RunCMake/cmake_minimum_required/Range.cmake 验证了这一行为执行cmake_minimum_required(VERSION 3.10...3.11)后CMAKE_MINIMUM_REQUIRED_VERSION被精确地赋值为3.10区间中的min部分其预期输出见 Tests/RunCMake/cmake_minimum_required/Range-stderr.txt^CMAKE_MINIMUM_REQUIRED_VERSION3\.10 CMP0071NEW CMP0072NEW CMP0073$FATAL_ERROR 选项面向老版本的历史遗留FATAL_ERROR选项在 CMake 2.6 及更高版本中被接受但会被忽略。它存在的唯一目的是当用户用CMake 2.4 及更低版本运行项目时让配置过程以错误error而非仅警告warning的方式失败退出。写法为cmake_minimum_required(VERSION 3.10 FATAL_ERROR)在源码参数解析中Source/cmCMakeMinimumRequired.cxxFATAL_ERROR只是一个被识别并跳过的关键字若它出现在VERSION之后且尚未提供版本值会报called with no value for VERSION错误若出现在其他位置则被忽略。对于现代 CMake 项目最低版本要求普遍 ≥ 3.5该选项已无实际影响保留它是为了与极早期 CMake 的兼容约定保持一致。Policy Version命令隐含的 cmake_policy 调用cmake_minimum_required(VERSION min[...policy_max])隐式执行cmake_policy(VERSION min[...policy_max])政策版本如何确定政策版本Policy Version的取值遵循以下优先级见 Help/command/include/POLICY_VERSION.rst若指定了policy_max则取policy_max否则取min若CMAKE_POLICY_VERSION_MINIMUM变量取值高于前两者则取该变量值。政策版本的含义是当前 CMake 代码是为给定版本区间[min, max]编写的。所有在政策版本或更早版本引入、且当前运行版本已知的 Policy都会被设置为NEW行为所有在更晚版本引入的 Policy 则保持未设置除非通过CMAKE_POLICY_DEFAULT_CMPNNNN变量设置了默认值未设置的 Policy 在行为可能变化时会产生警告。注意...policy_max绝不意味着禁止使用更新的 CMake。它只是声明该项目/模块已针对到policy_max为止引入的 Policy 做过主动适配更新的 CMake 依然可以运行该项目只是会对更新引入的新 Policy 给出警告提示项目作者或用户关注潜在行为差异。底层实现Policy 如何被批量设置从源码看cmake_minimum_required最终调用cmMakefile::SetPolicyVersionSource/cmMakefile.cxx后者进入cmPolicies::ApplyPolicyVersionSource/cmPolicies.cxx。该函数的核心逻辑是一个遍历全部 Policy 的循环第 349-368 行对不晚于政策版本的 PolicyisPolicyNewerThan判定为假直接SetPolicy(pid, cmPolicies::NEW)即强制启用新行为对晚于政策版本的 Policy默认设为WARN状态除非CMAKE_POLICY_DEFAULT_CMPNNNN提供了默认值行为差异会触发警告对已移除的 PolicyIsRemoved若项目仍想使用其OLD行为会触发DiagnoseAncientPolicies并设置致命错误第 370-375 行。这就是一行cmake_minimum_required替代大量cmake_policy(SET ...)的原理版本区间声明得越高被强制为NEW行为的 Policy 就越多项目的现代性也就越强。区间语法的可验证示例Tests/RunCMake/cmake_minimum_required/Range.cmake 给出了一个完整的可运行验证脚本cmake_minimum_required(VERSION 3.10...3.11) message(CMAKE_MINIMUM_REQUIRED_VERSION${CMAKE_MINIMUM_REQUIRED_VERSION}) foreach(policy CMP0071 CMP0072 CMP0073) cmake_policy(GET ${policy} status) message(${policy}${status}) endforeach()其预期输出Tests/RunCMake/cmake_minimum_required/Range-stderr.txt显示政策版本被定为 3.11因此在 3.11 及之前引入的CMP0071、CMP0072均为NEW而在 3.11 之后引入的CMP0073则为空未设置。这直观展示了区间上限决定哪些 Policy 被强制为 NEW的规则。未知参数的处理Future 测试揭示的细节当命令行出现未知参数时Source/cmCMakeMinimumRequired.cxx 中的EnforceUnknownArguments会给出宽容策略若给出了...policy_max且其版本高于当前运行的 CMake 版本则未知参数被容忍因为未来版本的语法当前版本无法完整理解。这与测试 Tests/RunCMake/cmake_minimum_required/Future.cmake 对应cmake_minimum_required(VERSION 3.11...99.0 SOME_FUTURE_OPTION)而若...policy_max小于等于当前版本未知参数会直接报错对应测试 Tests/RunCMake/cmake_minimum_required/Unknown.cmake 中的cmake_minimum_required(VERSION 3.11 SOME_UNKNOWN_OPTION)。这套机制保证了用旧 CMake 解析新项目时给出友好错误用未来 CMake 语法时保持兼容。放置位置必须位于顶层 CMakeLists.txt 开头官方文档明确要求在顶层CMakeLists.txt文件的开头调用cmake_minimum_required()且必须在调用project()命令之前。理由是要在其他命令的行为可能受版本和 Policy 影响之前先确立版本与 Policy 设置。这一要求由 PolicyCMP0000Help/policy/CMP0000.rst强制执行必须指定最低要求的 CMake 版本。CMake 要求项目声明其编写所针对的 CMake 版本以便用户在构建项目时能被告知何时需要升级 CMake项目能在比声明版本更新的 CMake 上正确构建。CMP0000 的NEW行为是对缺少版本声明的项目报错而非警告。同时注意该调用必须直接出现在CMakeLists.txt文件中——仅在被 include 的文件里调用是不够的。函数作用域中的限制文档特别提醒在function()内调用cmake_minimum_required()会带来混合效应见 Help/command/cmake_minimum_required.rstCMAKE_MINIMUM_REQUIRED_VERSION变量不会写入调用方作用域函数有独立变量作用域但 Policy 设置会影响调用方函数不引入独立 Policy 作用域。由于这种部分生效、部分不生效的割裂行为在函数中调用该命令通常是被明确劝阻的。正确的做法是在顶层作用域、任何project()之前完成版本声明。历史兼容版本从弃用到移除的时间线Help/command/include/DEPRECATED_POLICY_VERSIONS.rst记录了 CMake 对过旧政策版本的逐步收紧策略。所谓政策版本过旧指cmake_minimum_required(VERSION)或cmake_policy(VERSION)指定的版本低于某个门槛也可以通过...policy_max提升政策版本绕开。时间线如下CMake 版本变化门槛3.19弃用对早于2.8.12的兼容政策版本须 ≥ 2.8.12否则发出弃用警告3.27弃用对早于3.5的兼容政策版本须 ≥ 3.5否则发出弃用警告3.31弃用对早于3.10的兼容政策版本须 ≥ 3.10否则发出弃用警告4.0移除对早于3.5的兼容政策版本 3.5 直接报错这些规则同样适用于cmake_policy(VERSION)因为两者共享政策版本机制。当前仓库源码Source/cmPolicies.cxx正是 4.0 之后的状态政策版本早于 3.5 时直接触发致命错误提示-DCMAKE_POLICY_VERSION_MINIMUM3.5可尝试继续配置政策版本在3.5 ≤ v 3.10之间时发出Compatibility with CMake 3.10 will be removed from a future version of CMake的弃用诊断。对应的回归测试位于 Tests/RunCMake/cmake_minimum_required/BeforeVersionRemoved.cmakeVERSION 3.4与PolicyBeforeVersionRemoved.cmake验证 4.0 下的报错行为BeforeVersionDeprecated.cmakeVERSION 3.9验证弃用警告完整测试编排见 Tests/RunCMake/cmake_minimum_required/RunCMakeTest.cmake。CMAKE_POLICY_VERSION_MINIMUM不修改项目代码的兜底方案对于尚未更新到新政策版本的第三方项目CMake 4.0 提供了CMAKE_POLICY_VERSION_MINIMUM变量作为外部兜底Help/variable/CMAKE_POLICY_VERSION_MINIMUM.rst# 用户在命令行强制设定政策版本下限尝试配置未更新的项目 cmake -DCMAKE_POLICY_VERSION_MINIMUM3.5 -S path/to/project -B build其语义是政策版本取cmake_minimum_required/cmake_policy声明的版本与该变量值中的较高者实现见 Source/cmPolicies.cxx。该变量也可通过同名环境变量CMAKE_POLICY_VERSION_MINIMUM在新建构建树时自动初始化缓存条目Help/envvar/CMAKE_POLICY_VERSION_MINIMUM.rst或由项目在add_subdirectory()之前设置以约束第三方子项目的政策版本而不改动其代码。注意该变量不应被项目在自身 CMake 代码中用作设定自身政策版本的手段——那是cmake_minimum_required(VERSION)/cmake_policy(VERSION)的职责。测试 Tests/RunCMake/cmake_minimum_required/PolicyVersionVar.cmake 及其-D/-C/ 环境变量 / script 模式的多种组合系统验证了该变量的所有注入路径与非法值如...3.10报错行为。工程实践建议综合文档、源码与测试给出以下可直接落地的实践准则1. 每个项目的第一行或紧随注释就写版本声明cmake_minimum_required(VERSION 3.16...3.27) project(MyApp VERSION 1.2.3 LANGUAGES CXX)min应取你实际使用的最老特性所对应的版本policy_max应取你主动验证过的最新版本仓库中绝大多数示例项目如 Tests/AliasTarget/CMakeLists.txt、Tests/Architecture/CMakeLists.txt 均以cmake_minimum_required(VERSION 3.10)开头这与 3.31 起的弃用门槛保持一致。2. 遵循下限保守、上限现代原则min决定能否运行policy_max决定现代性。把policy_max写得很高并不会阻止老用户构建只要 ≥min只会让新 Policy 默认采用NEW行为减少警告。3. 远离函数作用域不要在function()内调用本命令如需在子目录中约束第三方代码优先使用CMAKE_POLICY_VERSION_MINIMUM变量。4. 遇到Compatibility with CMake 3.5 has been removed类错误要么更新项目自身的版本声明到 ≥ 3.5推荐要么按错误提示临时添加-DCMAKE_POLICY_VERSION_MINIMUM3.5继续配置但后者只是权宜之计。5. 用cmake --help-policy CMPxxxx深入排查当政策版本触发的警告出现时CMake 会提示运行该命令查看具体 Policy 的 OLD/NEW 行为差异见 Source/cmPolicies.cxx 的警告文案生成逻辑。总结cmake_minimum_required虽只有一行语法却承担着三重职责最低版本门禁、Policy 版本声明与历史兼容契约。理解其VERSION min[...policy_max]的完整语义——尤其是政策版本的三级取值规则与区间上限决定 NEW 行为覆盖范围的机制——是写出既能在旧环境运行、又能在新环境无警告构建的健壮 CMake 项目的前提。结合 Source/cmCMakeMinimumRequired.cxx 的参数解析与 Source/cmPolicies.cxx 的 Policy 批量设置逻辑以及 Tests/RunCMake/cmake_minimum_required/ 覆盖的各类边界场景开发者可以放心地将本命令作为每个 CMake 项目的第一行代码。赞分享构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载相关推荐火宝短剧如何用AI在5分钟内从创意到完整短剧视频火宝短剧如何用AI在5分钟内从创意到完整短剧视频 想要制作专业级短剧却苦于复杂的制作流程火宝短剧正是你需要的AI自动化解决方案这款基于AI的一站式短剧生成AI 应用人工智能媒体生成音视频AI Agent后端前端终极CMake版本控制完全指南从3.13到4.0的迁移策略与最佳实践终极CMake版本控制完全指南从3.13到4.0的迁移策略与最佳实践 CMake作为跨平台构建系统的核心工具其版本控制对于项目稳定性和团队协作至关重要。掌握构建工具开发工具CLICMake 旧版本兼容策略的弃用与移除从 cmake_minimum_required / cmake_policy 的版本约束谈起CMake 旧版本兼容策略的弃用与移除从 cmake_minimum_required / cmake_policy 的版本约束谈起 CMake 通过 CMP构建工具开发工具CLI上一篇NVIDIA Profile Inspector3步解锁显卡隐藏性能告别游戏卡顿下一篇5大核心功能解锁NVIDIA显卡隐藏性能Profile Inspector深度优化指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CMake 的 cmake_minimum_required 命令完全指南：版本校验、Policy 版本与最佳实践
构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载cmake_minimum_required是每个 CMake 项目CMakeLists.txt文件中的第一道守门员命令它声明项目运行所需的最低 CMake 版本并在配置阶段将整个项目的 Policy策略版本一次性设定到位。本篇以 CMake 官方命令文档Help/command/cmake_minimum_required.rst为骨架结合本仓库源码与测试用例深入讲解该命令的完整语法、版本区间语义、Policy 版本机制、历史版本兼容规则及放置位置等工程细节。读完本文你将能正确编写版本声明、理解3.10...3.27这类区间写法的真实含义并掌握在函数作用域、第三方子项目等复杂场景下的规避方案。命令语法与核心作用cmake_minimum_required的完整语法如下cmake_minimum_required(VERSION min[...policy_max] [FATAL_ERROR])该命令做两件事设定项目所需的最低 CMake 版本如果当前运行的 CMake 版本低于min配置过程会立即停止并报错更新 Policy 设置命令隐式调用cmake_policy(VERSION min[...policy_max])将项目政策版本Policy Version设定为指定值从而决定当前版本 CMake 中各项行为策略CMPxxxx默认采用NEW还是OLD行为。min与可选的policy_max都是形如major.minor[.patch[.tweak]]的 CMake 版本号其中...是字面量三个点不是省略号。例如cmake_minimum_required(VERSION 3.10...3.27)表示项目要求 CMake 至少为 3.10且已针对 3.27 及更早版本引入的 Policy 做过适配。...policy_max区间语法是 3.12 版本才引入的文档中标注versionadded:: 3.12旧版本 CMake3.12 之前会把...当作版本号分隔符从而忽略...policy_max部分回退到仅基于min设定 Policy 的旧行为。因此该语法向后兼容。版本校验运行版本过低时发生什么当用户用低于min的 CMake 配置项目时命令会停止处理项目并报告错误。从源码实现看Source/cmCMakeMinimumRequired.cxxCMake 会依次比较主版本号、次版本号、补丁号与 tweak 号四个分量if ((current_major required_major) || (current_major required_major current_minor required_minor) || (current_major required_major current_minor required_minor current_patch required_patch) || (current_major required_major current_minor required_minor current_patch required_patch current_tweak required_tweak)) { // The current version is too low. e CMake version_min or higher is required. You are running version cmVersion::GetCMakeVersion(); status.GetMakefile().IssueMessage(MessageType::FATAL_ERROR, e.str()); cmSystemTools::SetFatalErrorOccurred();未指定的版本分量按 0 处理源码第 82-85 行因此VERSION 3.10等价于3.10.0.0。版本解析使用sscanf要求至少解析出major.minor两个分量否则直接报could not parse VERSION错误Source/cmCMakeMinimumRequired.cxx。当版本过低时用户会看到形如CMake 3.27 or higher is required. You are running version 3.16.3的致命错误信息。命令同时会把min写入CMAKE_MINIMUM_REQUIRED_VERSION变量源码 Source/cmCMakeMinimumRequired.cxx方便脚本在配置过程中查询项目声明的最低版本cmake_minimum_required(VERSION 3.10) message(STATUS Minimum required version: ${CMAKE_MINIMUM_REQUIRED_VERSION}) # 输出Minimum required version: 3.10测试目录 Tests/RunCMake/cmake_minimum_required/Range.cmake 验证了这一行为执行cmake_minimum_required(VERSION 3.10...3.11)后CMAKE_MINIMUM_REQUIRED_VERSION被精确地赋值为3.10区间中的min部分其预期输出见 Tests/RunCMake/cmake_minimum_required/Range-stderr.txt^CMAKE_MINIMUM_REQUIRED_VERSION3\.10 CMP0071NEW CMP0072NEW CMP0073$FATAL_ERROR 选项面向老版本的历史遗留FATAL_ERROR选项在 CMake 2.6 及更高版本中被接受但会被忽略。它存在的唯一目的是当用户用CMake 2.4 及更低版本运行项目时让配置过程以错误error而非仅警告warning的方式失败退出。写法为cmake_minimum_required(VERSION 3.10 FATAL_ERROR)在源码参数解析中Source/cmCMakeMinimumRequired.cxxFATAL_ERROR只是一个被识别并跳过的关键字若它出现在VERSION之后且尚未提供版本值会报called with no value for VERSION错误若出现在其他位置则被忽略。对于现代 CMake 项目最低版本要求普遍 ≥ 3.5该选项已无实际影响保留它是为了与极早期 CMake 的兼容约定保持一致。Policy Version命令隐含的 cmake_policy 调用cmake_minimum_required(VERSION min[...policy_max])隐式执行cmake_policy(VERSION min[...policy_max])政策版本如何确定政策版本Policy Version的取值遵循以下优先级见 Help/command/include/POLICY_VERSION.rst若指定了policy_max则取policy_max否则取min若CMAKE_POLICY_VERSION_MINIMUM变量取值高于前两者则取该变量值。政策版本的含义是当前 CMake 代码是为给定版本区间[min, max]编写的。所有在政策版本或更早版本引入、且当前运行版本已知的 Policy都会被设置为NEW行为所有在更晚版本引入的 Policy 则保持未设置除非通过CMAKE_POLICY_DEFAULT_CMPNNNN变量设置了默认值未设置的 Policy 在行为可能变化时会产生警告。注意...policy_max绝不意味着禁止使用更新的 CMake。它只是声明该项目/模块已针对到policy_max为止引入的 Policy 做过主动适配更新的 CMake 依然可以运行该项目只是会对更新引入的新 Policy 给出警告提示项目作者或用户关注潜在行为差异。底层实现Policy 如何被批量设置从源码看cmake_minimum_required最终调用cmMakefile::SetPolicyVersionSource/cmMakefile.cxx后者进入cmPolicies::ApplyPolicyVersionSource/cmPolicies.cxx。该函数的核心逻辑是一个遍历全部 Policy 的循环第 349-368 行对不晚于政策版本的 PolicyisPolicyNewerThan判定为假直接SetPolicy(pid, cmPolicies::NEW)即强制启用新行为对晚于政策版本的 Policy默认设为WARN状态除非CMAKE_POLICY_DEFAULT_CMPNNNN提供了默认值行为差异会触发警告对已移除的 PolicyIsRemoved若项目仍想使用其OLD行为会触发DiagnoseAncientPolicies并设置致命错误第 370-375 行。这就是一行cmake_minimum_required替代大量cmake_policy(SET ...)的原理版本区间声明得越高被强制为NEW行为的 Policy 就越多项目的现代性也就越强。区间语法的可验证示例Tests/RunCMake/cmake_minimum_required/Range.cmake 给出了一个完整的可运行验证脚本cmake_minimum_required(VERSION 3.10...3.11) message(CMAKE_MINIMUM_REQUIRED_VERSION${CMAKE_MINIMUM_REQUIRED_VERSION}) foreach(policy CMP0071 CMP0072 CMP0073) cmake_policy(GET ${policy} status) message(${policy}${status}) endforeach()其预期输出Tests/RunCMake/cmake_minimum_required/Range-stderr.txt显示政策版本被定为 3.11因此在 3.11 及之前引入的CMP0071、CMP0072均为NEW而在 3.11 之后引入的CMP0073则为空未设置。这直观展示了区间上限决定哪些 Policy 被强制为 NEW的规则。未知参数的处理Future 测试揭示的细节当命令行出现未知参数时Source/cmCMakeMinimumRequired.cxx 中的EnforceUnknownArguments会给出宽容策略若给出了...policy_max且其版本高于当前运行的 CMake 版本则未知参数被容忍因为未来版本的语法当前版本无法完整理解。这与测试 Tests/RunCMake/cmake_minimum_required/Future.cmake 对应cmake_minimum_required(VERSION 3.11...99.0 SOME_FUTURE_OPTION)而若...policy_max小于等于当前版本未知参数会直接报错对应测试 Tests/RunCMake/cmake_minimum_required/Unknown.cmake 中的cmake_minimum_required(VERSION 3.11 SOME_UNKNOWN_OPTION)。这套机制保证了用旧 CMake 解析新项目时给出友好错误用未来 CMake 语法时保持兼容。放置位置必须位于顶层 CMakeLists.txt 开头官方文档明确要求在顶层CMakeLists.txt文件的开头调用cmake_minimum_required()且必须在调用project()命令之前。理由是要在其他命令的行为可能受版本和 Policy 影响之前先确立版本与 Policy 设置。这一要求由 PolicyCMP0000Help/policy/CMP0000.rst强制执行必须指定最低要求的 CMake 版本。CMake 要求项目声明其编写所针对的 CMake 版本以便用户在构建项目时能被告知何时需要升级 CMake项目能在比声明版本更新的 CMake 上正确构建。CMP0000 的NEW行为是对缺少版本声明的项目报错而非警告。同时注意该调用必须直接出现在CMakeLists.txt文件中——仅在被 include 的文件里调用是不够的。函数作用域中的限制文档特别提醒在function()内调用cmake_minimum_required()会带来混合效应见 Help/command/cmake_minimum_required.rstCMAKE_MINIMUM_REQUIRED_VERSION变量不会写入调用方作用域函数有独立变量作用域但 Policy 设置会影响调用方函数不引入独立 Policy 作用域。由于这种部分生效、部分不生效的割裂行为在函数中调用该命令通常是被明确劝阻的。正确的做法是在顶层作用域、任何project()之前完成版本声明。历史兼容版本从弃用到移除的时间线Help/command/include/DEPRECATED_POLICY_VERSIONS.rst记录了 CMake 对过旧政策版本的逐步收紧策略。所谓政策版本过旧指cmake_minimum_required(VERSION)或cmake_policy(VERSION)指定的版本低于某个门槛也可以通过...policy_max提升政策版本绕开。时间线如下CMake 版本变化门槛3.19弃用对早于2.8.12的兼容政策版本须 ≥ 2.8.12否则发出弃用警告3.27弃用对早于3.5的兼容政策版本须 ≥ 3.5否则发出弃用警告3.31弃用对早于3.10的兼容政策版本须 ≥ 3.10否则发出弃用警告4.0移除对早于3.5的兼容政策版本 3.5 直接报错这些规则同样适用于cmake_policy(VERSION)因为两者共享政策版本机制。当前仓库源码Source/cmPolicies.cxx正是 4.0 之后的状态政策版本早于 3.5 时直接触发致命错误提示-DCMAKE_POLICY_VERSION_MINIMUM3.5可尝试继续配置政策版本在3.5 ≤ v 3.10之间时发出Compatibility with CMake 3.10 will be removed from a future version of CMake的弃用诊断。对应的回归测试位于 Tests/RunCMake/cmake_minimum_required/BeforeVersionRemoved.cmakeVERSION 3.4与PolicyBeforeVersionRemoved.cmake验证 4.0 下的报错行为BeforeVersionDeprecated.cmakeVERSION 3.9验证弃用警告完整测试编排见 Tests/RunCMake/cmake_minimum_required/RunCMakeTest.cmake。CMAKE_POLICY_VERSION_MINIMUM不修改项目代码的兜底方案对于尚未更新到新政策版本的第三方项目CMake 4.0 提供了CMAKE_POLICY_VERSION_MINIMUM变量作为外部兜底Help/variable/CMAKE_POLICY_VERSION_MINIMUM.rst# 用户在命令行强制设定政策版本下限尝试配置未更新的项目 cmake -DCMAKE_POLICY_VERSION_MINIMUM3.5 -S path/to/project -B build其语义是政策版本取cmake_minimum_required/cmake_policy声明的版本与该变量值中的较高者实现见 Source/cmPolicies.cxx。该变量也可通过同名环境变量CMAKE_POLICY_VERSION_MINIMUM在新建构建树时自动初始化缓存条目Help/envvar/CMAKE_POLICY_VERSION_MINIMUM.rst或由项目在add_subdirectory()之前设置以约束第三方子项目的政策版本而不改动其代码。注意该变量不应被项目在自身 CMake 代码中用作设定自身政策版本的手段——那是cmake_minimum_required(VERSION)/cmake_policy(VERSION)的职责。测试 Tests/RunCMake/cmake_minimum_required/PolicyVersionVar.cmake 及其-D/-C/ 环境变量 / script 模式的多种组合系统验证了该变量的所有注入路径与非法值如...3.10报错行为。工程实践建议综合文档、源码与测试给出以下可直接落地的实践准则1. 每个项目的第一行或紧随注释就写版本声明cmake_minimum_required(VERSION 3.16...3.27) project(MyApp VERSION 1.2.3 LANGUAGES CXX)min应取你实际使用的最老特性所对应的版本policy_max应取你主动验证过的最新版本仓库中绝大多数示例项目如 Tests/AliasTarget/CMakeLists.txt、Tests/Architecture/CMakeLists.txt 均以cmake_minimum_required(VERSION 3.10)开头这与 3.31 起的弃用门槛保持一致。2. 遵循下限保守、上限现代原则min决定能否运行policy_max决定现代性。把policy_max写得很高并不会阻止老用户构建只要 ≥min只会让新 Policy 默认采用NEW行为减少警告。3. 远离函数作用域不要在function()内调用本命令如需在子目录中约束第三方代码优先使用CMAKE_POLICY_VERSION_MINIMUM变量。4. 遇到Compatibility with CMake 3.5 has been removed类错误要么更新项目自身的版本声明到 ≥ 3.5推荐要么按错误提示临时添加-DCMAKE_POLICY_VERSION_MINIMUM3.5继续配置但后者只是权宜之计。5. 用cmake --help-policy CMPxxxx深入排查当政策版本触发的警告出现时CMake 会提示运行该命令查看具体 Policy 的 OLD/NEW 行为差异见 Source/cmPolicies.cxx 的警告文案生成逻辑。总结cmake_minimum_required虽只有一行语法却承担着三重职责最低版本门禁、Policy 版本声明与历史兼容契约。理解其VERSION min[...policy_max]的完整语义——尤其是政策版本的三级取值规则与区间上限决定 NEW 行为覆盖范围的机制——是写出既能在旧环境运行、又能在新环境无警告构建的健壮 CMake 项目的前提。结合 Source/cmCMakeMinimumRequired.cxx 的参数解析与 Source/cmPolicies.cxx 的 Policy 批量设置逻辑以及 Tests/RunCMake/cmake_minimum_required/ 覆盖的各类边界场景开发者可以放心地将本命令作为每个 CMake 项目的第一行代码。赞分享构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载相关推荐火宝短剧如何用AI在5分钟内从创意到完整短剧视频火宝短剧如何用AI在5分钟内从创意到完整短剧视频 想要制作专业级短剧却苦于复杂的制作流程火宝短剧正是你需要的AI自动化解决方案这款基于AI的一站式短剧生成AI 应用人工智能媒体生成音视频AI Agent后端前端终极CMake版本控制完全指南从3.13到4.0的迁移策略与最佳实践终极CMake版本控制完全指南从3.13到4.0的迁移策略与最佳实践 CMake作为跨平台构建系统的核心工具其版本控制对于项目稳定性和团队协作至关重要。掌握构建工具开发工具CLICMake 旧版本兼容策略的弃用与移除从 cmake_minimum_required / cmake_policy 的版本约束谈起CMake 旧版本兼容策略的弃用与移除从 cmake_minimum_required / cmake_policy 的版本约束谈起 CMake 通过 CMP构建工具开发工具CLI上一篇NVIDIA Profile Inspector3步解锁显卡隐藏性能告别游戏卡顿下一篇5大核心功能解锁NVIDIA显卡隐藏性能Profile Inspector深度优化指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考