如何在CMake 3(.27(.7))中仅检查语法结构而不执行命令？

以下是几种仅验证CMake脚本语法和结构、不执行实际构建命令的实用方式：

• 检查单个CMake脚本的语法
  若只需验证单个.cmake脚本或CMakeLists.txt的语法正确性，可使用cmake -P配合--check-system-vars选项，执行时仅做语法校验，不会运行脚本逻辑：

  cmake --check-system-vars -P path/to/your/script.cmake
  

  针对项目根目录的CMakeLists.txt，直接执行：

  cmake --check-system-vars -P CMakeLists.txt
  

• 检查整个项目的配置语法与结构
  要验证整个项目的CMake配置（含所有子目录的CMakeLists.txt），可以用cmake -S <源码目录> -B <构建目录> --no-build，该命令会完成配置阶段的语法和结构检查，但不会触发后续构建步骤：

  cmake -S . -B build --no-build
  

  若需要更详细的检查日志，可添加--log-level=VERBOSE定位潜在问题：

  cmake -S . -B build --no-build --log-level=VERBOSE
  

• 使用cmake --verify（CMake 3.19+支持）
  该命令专门用于验证CMake脚本的语法与结构，支持单个文件或整个项目的检查：

  cmake --verify path/to/CMakeLists.txt
  

  针对项目源码目录执行：

  cmake --verify -S .
  

这些命令仅校验语法、结构及变量引用的合法性，不会执行编译、链接等实际构建操作，适合代码合并前的预检查，避免配置错误引入项目。

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