STM32高级开发——使用VS Code搭建STM32开发环境
内容提要
本文介绍了在Windows平台上使用Visual Studio Code搭建开发环境的步骤和插件使用方法，包括软件安装、配置、开发工程步骤和调试功能设置。
延伸解读
环境变量配置是工具链协同工作的关键
文章反复强调将Clang、OpenOCD、arm-none-eabi-gcc的bin目录加入PATH，并在VS Code设置中指定Git bash路径。这并非多余步骤：VS Code本身不内置编译调试能力，而是通过插件调用外部工具。若路径遗漏或错误，语法补全、编译、调试将分别失效。读者应逐一核对每个工具的安装路径，并确保在命令行中能直接调用，再进入VS Code配置，可减少后续排查成本。
Makefile与c_cpp_properties.json需手动同步
文章指出VS Code不会自动读取Makefile中的编译参数，因此即使调试能运行，代码索引和智能感知也可能不准确。解决办法是单独配置c_cpp_properties.json中的includePath、defines和path。这意味着开发者需要从Makefile中提取头文件目录和宏定义，手动填入该文件。对于工程结构复杂或宏定义较多的项目，这一步骤容易遗漏，建议在修改Makefile后同步更新此文件，以保证编辑体验与编译结果一致。
调试启动需注意路径分隔符与断点设置
launch.json的配置涉及Windows cmd与MinGW64终端之间的跳转，文章提醒要分清“/”和“\”的路径表示方法，否则调试可能失败。此外，由于插件自身bug，调试启动后不会自动停在main函数入口，需要手动在代码第二行或main入口设置断点。这两点属于实操中的常见坑：前者要求仔细对照调试窗口的打印记录调整路径，后者则需养成调试前先设断点的习惯，避免误以为程序未运行。
Q&A
在Windows上用VS Code搭建STM32开发环境需要安装哪些软件？
需要安装Visual Studio Code、Clang、Git for Windows、OpenOCD for Windows和arm-none-eabi-gcc。安装VS Code时记得勾选“添加右键打开文件和文件夹”选项；Clang、OpenOCD和arm-none-eabi-gcc安装后需将其bin文件夹路径添加到环境变量PATH中。
VS Code中需要安装哪些插件来支持STM32开发？
需要安装以下插件：ARM（提供ARM汇编语法识别加亮）、C/C++（提供C/C++语法智能感知、加亮及调试功能）、C/C++ Clang Command Adapter（提供Clang功能调用）、Code Outline（提供文件函数列表）、GBKtoUTF8（识别调整文件编码格式）、Makefiles support for VSCode（提供Makefile语法识别等功能）。
如何配置VS Code的集成终端为MINGW64？
在VS Code设置文件（通过文件->首选项->设置打开）中添加配置："terminal.integrated.shell.windows": "D:\\Git\\bin\\bash.exe" 和 "terminal.external.windowsExec": "D:\\Git\\bin\\bash.exe"，路径需根据实际Git安装位置修改。重启VS Code后，点击查看->集成终端即可看到终端变为MINGW64。
使用CubeMX生成的Makefile工程时，需要修改Makefile的哪些内容？
需要修改Makefile中arm-none-eabi-gcc的路径设置。由于已将工具链路径加入环境变量，只需将执行指令前的路径变量全部删除，即设置BINPATH为空，PREFIX为arm-none-eabi-，例如：BINPATH =、PREFIX = arm-none-eabi-。
launch.json、c_cpp_properties.json和settings.json分别有什么作用？
launch.json用于设定调试功能，需修改路径为自身工程路径；c_cpp_properties.json用于设定工程的Include路径、宏定义及搜索浏览路径，确保代码索引和智能感知正确；settings.json用于设定工程中VS Code的特殊设置，如代码格式化样式等。
调试时如何避免插件bug导致程序不停在main函数入口？
由于插件本身的bug，调试启动后不会自动停在代码起始位置或main函数入口。解决方法是在调试前在代码运行的第二行或者main函数入口手动添加一个断点，这样调试启动后就会停在该断点处。
