STM32 CMake 构建 当任务重点在构建侧,而不是烧录或串口观测时,使用这个 skill。它负责识别正确的 preset、执行 configure/build、确认产物路径,并保持构建链路稳定。 适用场景 STM32 工程包含 CMakeLists.txt 工程已经使用 CMakePresets.json 需要确认或选择 Debug、Release 等 preset 需要处理 configure 或 compile 错误 需要确认 .elf、.bin、.map 等构建产物 工作流程 先检查工程结构。 重点看 CMakePresets.json、CMakeLists.txt、现有 build/ 目录、工具链文件和工程说明。 复用工程已有构建方式。 优先使用工程定义的 preset,不随意新建 build 目录或切换 generator。 先 configure,再 build。 在 Windows PowerShell 下优先使用: cmake --preset cmake --build --preset 明确确认产物路径。 不假设 .elf 的位置,必须以实际构建结果为准,为后续烧录提供准确输入。 把 configure 错误和 compile 错误分开处理。 configure 失败先看 preset、generator、toolchain 和环境;compile 失败再看源码、头文件、宏定义和生成文件。 操作规则 默认假设环境是 Windows + PowerShell。 一步一个命令,避免把多个动作揉在一起。 没有充分理由时,不要在调试中途切换 preset。 没有充分证据时,不要替换工具链。 只要用户反馈“代码改了但板子没变”,先确认目标二进制是否真的重新构建出来了。 判断优先级 如果代码改动没有体现在目标设备上,先怀疑 preset 错、artifact 错,再怀疑烧录或运行时逻辑。 如果存在多个 build 目录,必须先确认当前工程实际用的是哪一个。 如果产物路径不清楚,优先查 preset 和 target 输出,而不是猜路径。 参考资料 需要具体命令模板和产物检查顺序时,读 references/playbook.md。