CMakePresets.json与cmake区别
2026/6/10 15:24:49 网站建设 项目流程

CMakePresets.json 是干什么的?

一句话CMakePresets.json是用来预先定义一组“配置/编译方案”的标准配置文件,方便你在命令行或 IDE 里一键选择,而不用每次自己拼-G -DCMAKE_TOOLCHAIN_FILE=... -DCMAKE_BUILD_TYPE=...这些参数。

  • 典型功能
    • 统一定义多个构建配置(如Debug/Release/arm-gcc-debug等)。
    • 指定构建目录(build/Debugbuild/Release等)。
    • 指定工具链文件(比如你项目里的tools/cmake_toolchain_files/armgcc.cmake)。
    • 传各种-DXXX=ON/OFF选项。

它和.cmake文件的本质区别

  • CMakePresets.json

    • 是一个“如何调用 cmake 的配置清单”
    • 作用范围:外部(调用 cmake 时,决定用什么生成器、什么工具链、放到哪个 build 目录、开哪些选项)。
    • 用法:cmake --preset <名字>、IDE 里的 “Configure Preset / Build Preset” 下拉菜单。
  • xxx.cmake(模块/工具链等)

    • cmake 语言写的脚本,在CMake 运行过程中被include()/toolchain使用
    • 比如:
      • tools/cmake_toolchain_files/armgcc.cmake:定义交叉编译器路径、cpu 选项等 → 典型工具链文件
      • flags.cmake、某些SDK/.../*.cmake:设置编译选项、添加库、宏等 → 典型模块/配置脚本
    • 用法:
      • 在命令行:-DCMAKE_TOOLCHAIN_FILE=tools/cmake_toolchain_files/armgcc.cmake
      • 或在CMakeLists.txt里:include(flags.cmake)等。

对比总结

  • Presets(json):告诉 cmake“怎么启动、用哪个工具链、放哪编”
  • .cmake 脚本:在 cmake 运行时,告诉 cmake“怎么配置项目自身:用哪些编译选项、哪些库、交叉编译器在哪”

在你的工程里,大概怎么用 Presets

结合你的项目结构(已存在CMakePresets.jsontools/cmake_toolchain_files/armgcc.cmake):

  • 在命令行构建:
# 查看有哪些 presetcmake --list-presets# 用某个配置 preset(例如叫 "armgcc-debug")生成 build 目录cmake --preset armgcc-debug# 用某个 build preset 编译cmake --build --preset armgcc-debug
  • 在 VS Code / CLion / VS:
    • 打开工程根目录(有CMakePresets.json那层)。
    • IDE 会自动识别 presets,弹出配置选项,你直接选Debug/Release/armgcc-debug
    • 之后直接点Configure / Build就会按 preset 里定义的参数运行。

什么时候改 Presets?什么时候改 .cmake?

  • CMakePresets.json

    • 想新增一种编译方案:比如同一个源码,既要为 Windows x64 编,又要为 i.MX8 ARM 编。
    • 想换构建目录命名、默认构建类型、默认工具链等。
  • .cmake(如armgcc.cmakeflags.cmake

    • 想改交叉编译器路径、CPU 选项、FPU 选项。
    • 想统一调整-O2/-O0/-g、警告等级、宏定义、链接脚本等。

如果你愿意,可以把当前的CMakePresets.json内容贴出来,我可以逐项解释每个字段具体对你这个 i.MX8 + AD7606 工程的含义。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询