CMake调试与详细输出选项解析

在使用 CMake 进行项目构建和编译时，--debug-output 和 --verbose 的作用如下：

1. --debug-output

• 适用阶段：CMake 配置阶段（运行 cmake 命令生成构建系统时）。
• 作用：
  启用 CMake 内部的调试输出，显示详细的配置过程信息，例如：
  • 变量的值（如 CMAKE_CXX_COMPILER）。
  • 条件判断（如 if() 语句）的逻辑结果。
  • 加载的脚本文件（如 CMakeLists.txt 或 .cmake 模块）的执行路径。
• 用途：
  调试 CMakeLists.txt 的配置逻辑，定位变量未正确设置或条件分支未按预期执行等问题。
• 示例：

  cmake -S . -B build --debug-output
  

2. --verbose

• 适用阶段：CMake 构建阶段（运行 cmake --build 编译项目时）。
• 作用：
  让底层的构建工具（如 Make 或 Ninja）输出详细的编译命令，例如：
  • 完整的编译指令（如 g++ -O2 -Iinclude ...）。
  • 链接步骤的具体参数。
  • 文件依赖关系和构建顺序。
• 用途：
  查看编译错误的具体原因，或验证编译参数是否按预期传递。
• 示例：

  cmake --build build --verbose
  # 或简写为：
  cmake --build build -v
  

注意事项

1. 选项格式：

   • --debug-output 是 CMake 配置时的选项，通常用连字符（-），而非下划线（_）。
   • --verbose 是构建阶段的选项，也可简写为 -v（某些构建工具支持）。

2. 构建工具的替代方法：
   某些构建工具（如 Make）可以直接通过环境变量启用详细输出：

   # 对 Make 构建系统：
   cmake --build build -- -j VERBOSE=1
   

3. 其他调试选项：

   • --trace：跟踪 CMake 脚本的执行过程（更详细，适用于复杂调试）。
   • -DCMAKE_VERBOSE_MAKEFILE=ON：生成始终输出详细日志的构建文件。

总结

• --debug-output：调试 CMake 配置阶段的问题（如变量、逻辑错误）。
• --verbose：查看构建阶段的详细编译命令（如参数传递、文件依赖）。
  根据问题发生的阶段选择合适的选项。