CMake 命令行参数完全指南 （1）
参数说明约定
- 术语解释：对专业术语提供通俗解释
- 适用场景：参数的最佳使用时机
- 输入要求：需要用户提供哪些输入
- 示例：基于
build目录的实际用例 - 初学者提示：针对新手的特别说明
cmake - 参数详解
1. -A <platform-name>
解释：指定目标平台名称（用于交叉编译）
术语说明：交叉编译指在一种操作系统上编译另一种操作系统的程序
输入要求：平台名称字符串（如 “Win32”、“ARM”）
适用场景：为不同操作系统或硬件平台编译程序
示例：
cmake -B build -A "Win32" # 为32位Windows系统编译
cmake -B build -A "ARM" # 为ARM架构设备编译
初学者提示：普通PC开发通常不需要此参数
[[扩展说明：-A 参数]]
**2. -B <build-directory>**
解释：指定构建文件存放位置
术语说明：构建目录是存放编译中间文件的独立文件夹
输入要求：目录路径（相对或绝对）
适用场景：所有CMake项目初始化
示例：
cmake -B build # 创建build文件夹存放编译文件
初学者提示：必须掌握的核心参数，保持源码目录整洁
**3. --build <dir>**
解释：执行实际编译操作
输入要求：已存在的构建目录路径
适用场景：生成可执行文件或库
示例：
cmake --build build # 编译项目
cmake --build build -j 4 # 使用4个CPU核心并行编译
初学者提示：编译前需先用 -B 生成构建系统
**4. -C <initial-cache-file>**
解释：预加载缓存文件设置默认值
术语说明：缓存文件存储CMake配置参数
输入要求：CMake脚本文件路径（.cmake格式）
适用场景：项目标准化配置
示例：
cmake -B build -C default_settings.cmake
文件内容示例：
# default_settings.cmake
set(CMAKE_BUILD_TYPE Debug)
set(USE_OPENMP ON)
**5. --check-system-vars**
解释：检查系统环境变量是否被使用
适用场景：调试环境配置问题
示例：
cmake -B build --check-system-vars
初学者提示：高级调试参数，新手可暂不关注
**6. -D <var>[=<value>]**
解释：设置配置参数（最常用参数）
术语说明：变量是CMake存储配置信息的容器
输入要求：变量名和可选值（格式：VAR=VALUE）
适用场景：控制功能开关、设置路径等
示例：
cmake -B build -DCMAKE_BUILD_TYPE=Release # 设置发布模式
cmake -B build -DUSE_OPENMP=ON # 启用OpenMP支持
初学者提示：必须掌握的核心参数，项目配置的基础
**7. --debug-output**
解释：显示详细处理过程
适用场景：调试CMake脚本问题
示例：
cmake -B build --debug-output
输出示例：
...详细显示CMake执行的每一步...
**8. --debug-trycompile**
解释：显示编译器测试的详细信息
术语说明：CMake会测试编译器功能以确定兼容性
适用场景：诊断编译器兼容性问题
示例：
cmake -B build --debug-trycompile
**9. -E**
解释：调用CMake内置工具命令
支持的命令：通过 cmake -E help 查看完整列表
适用场景：文件操作等通用任务
示例：
cmake -E make_directory new_folder # 创建目录
cmake -E copy file.txt file_copy.txt # 复制文件
cmake -E compare_files file1.txt file2.txt # 比较文件
**10. --find-package**
解释：模拟包查找过程
输入要求：需配合 -D 参数指定查找参数
适用场景：调试第三方库查找问题
示例：
cmake --find-package -DNAME=OpenMP -DCOMPILER_ID=GNU
https://github.com/0voice