我大概是在好几个STM32项目里被Keil的编辑器折磨到没脾气之后才下定决心把整个开发流程迁到VS Code的。说句实在话Keil的编译和调试确实稳但那个写代码的体验和现代编辑器之间差着整整一个时代。这个系列叫“嵌入式软件AI编程”第07篇的核心任务是给STM32开发环境装好VS Code和配套扩展工具——听起来好像就是个安装教程但真做起来从版本选择、插件筛选、编译器搭配到AI插件接入每一步都有讲究。尤其是你打算用AI来辅助写代码时编辑器和工具链选得对不对会直接影响你后面几个月的开发顺不顺。这篇环境安装教程主要面向正在入门STM32、准备尝试AI辅助开发但之前一直用Keil或者其他老旧IDE的工程师和同学。我默认你已经有一块能用的STM32板子最好是带板载ST-Link的Nucleo或类似开发板这样烧录和调试部分可以直接跟着做。下面从头到尾走一遍包括我踩过的坑和最后留下的习惯配置。1. 替换Keil不是件小事为什么非要为AI编程重整开发环境1.1 Keil编辑器真正缺的是什么先说结论如果你的目标是“写代码更顺手、让AI能帮你写代码”Keil的编辑器本身是硬瓶颈这不是换换主题、装个插件能解决的。Keil用的还是老一套的代码编辑模型。代码自动补全能力很弱很多时候只提示到函数名、变量名的程度结构体成员、宏定义展开、模板代码这些基本指望不上。语义高亮也粗糙代码一多整个文件就像一块贴满便签的白板扫一眼根本找不到关键逻辑。更麻烦的是Keil没有真正意义上的插件生态外面那些AI编程工具比如通义灵码、CodeGeeX、Continue几乎全部优先支持VS CodeKeil根本不在它们的适配名单里。换句话说你希望AI帮你补全代码、解释报错、生成初始化逻辑第一步不是找AI工具而是先把编辑器换成AI工具能落地的环境。VS Code就是目前承载嵌入式AI编程最好的宿主。1.2 VS Code AI插件能带来的实际变化我自己的体感是这样换到VS Code之后代码补全从“关键词级提示”变成“语义级补全”。装了C/C扩展并正确配置IntelliSense后输入HAL_GPIO_WritePin它会根据你include的头文件和宏定义把参数都列出来甚至能提示传入的GPIO引脚名。这个体验Keil里很难实现。再加上AI插件后变化更直接。比如我想初始化一个定时器以前要么翻手册查寄存器要么从旧工程复制一份再改参数。现在直接在对话面板里说一句“用STM32F103的TIM2输出两路PWM频率20kHz占空比50%”AI会生成完整配置代码我检查一遍时钟树和引脚号之后粘进工程基本就能跑。这个流程极大压缩了从查手册到写代码的时间。1.3 这套环境能做什么、不能做什么我得先把预期管理好避免你装完环境后发现“也没那么神”。这套环境能做的事很清楚在VS Code里看代码、写代码、补全代码一键编译工程一键烧录固件到STM32在线断点调试通过AI插件做代码生成、解释、审查。这些都能稳定跑通。但它不能替代你理解芯片本身。AI生成代码时如果你不懂GPIO模式、定时器时钟分频、DMA请求映射这些基础概念很难判断生成结果是不是对的。环境只是工具芯片手册和硬件调试能力还是得自己长在身上。2. 安装VS Code选版本、勾选项和第一次启动要干的活2.1 下载哪个安装包User Installer优先去VS Code官网下载时会看到两个Windows版本User Installer和System Installer。我的建议是如果你用的是自己日常办公的电脑且只有一个Windows账户优先选User Installer。它不需要管理员权限装在用户目录下后续手动更新也好、装扩展也好基本不会遇到UAC弹窗拦路。如果是在公司配发的电脑上装或者你经常需要切换多个Windows账户共用这台机器那就选System Installer装到Program Files所有用户都能用。安装过程没什么特别一路Next也行。但我不建议直接无脑Next下面几个选项值得单独确认。2.2 安装向导里的关键勾选安装向导中间有一个“选择附加任务”的页面很多人扫一眼就跳过了其实这里藏着三个后续会省很多事的东西添加到PATH这个必须勾。只有勾了你之后在终端里才能直接输入code命令打开VS Code很多教程和脚本都依赖这个命令。添加到“打开方式”列表和文件夹右键菜单建议勾上。你以后在资源管理器里右键一个.c文件或者右键一个工程目录直接就能用VS Code打开不用先开编辑器再去找文件。注册为支持的文件类型编辑器可勾可不勾。如果勾了以后双击.c、.h文件会默认用VS Code打开Keil项目里的源码文件也会受影响。这个看个人习惯我喜欢保留Keil双击打开所以没勾。安装完成后建议先别急着装插件打开VS Code第一件事确认左下角显示的版本号。等以后排查插件兼容性问题时版本信息通常最先用到。2.3 第一次启动要干的活中文、自动保存、字体VS Code默认是全英文界面。除非你英文阅读毫无障碍否则我建议顺手把中文语言包装上。打开扩展面板左侧边栏的方块图标搜索“Chinese”找到微软出的“中文简体语言包”安装后右下角会提示重启重启后界面就是中文了。接下来改几个编辑器的基础设置。按Ctrl ,打开设置界面建议优先改这几项Auto Save自动保存把“files.autoSave”改成afterDelay延迟时间设成1000毫秒。嵌入式工程里你写代码时经常忘记按保存就去编译编译出来还是旧代码排查半天才发现没保存。自动保存能省掉这个低级错误。Editor: Font Size字体大小我自己用16px长时间看不累。推荐14~16之间。Editor: Tab Size缩进尺寸STM32的C代码风格以4空格缩进为主把Tab Size设为4同时勾选“Detect Indentation”取消掉避免它根据文件内容自动切换。Word Wrap自动换行改成on否则注释写长了会横向滚动看着很难受。这些属于“谁装完环境都会做”的基础设置做完了再去碰编译链和插件才不容易被界面问题打断思路。3. STM32扩展工具清单五个必装三个按需装VS Code强在扩展生态但生态丰富也意味着容易选择困难。我重新整理过自己几台电脑上的扩展列表精简掉了不少“看着有用实际吃灰”的插件。针对STM32开发核心就五件套。3.1 五个必装扩展分别解决什么问题下面这几个扩展是我每次新装环境时必装的少一个都会别扭扩展发布者作用C/CMicrosoft代码补全、智能提示、符号跳转、调试支持IntelliSense核心Cortex-DebugMarus通过OpenOCD、ST-Link等对ARM Cortex-M芯片进行在线调试STM32 VS Code ExtensionSTMicroelectronicsST官方插件可配合STM32CubeMX创建工程、一键构建并烧录Embedded ToolsMicrosoft嵌入式开发辅助工具提供嵌入式项目的工程管理和语法识别能力Chinese语言包中文界面插件Microsoft界面中文化降低使用门槛这里重点说下C/C扩展和Cortex-Debug的分工。C/C负责的是“读代码”这一侧——它扫描整个工程里的头文件、宏定义和源码路径建立起符号索引让你能跳转定义、看到变量类型、补全成员。Cortex-Debug负责的是“调试”这一侧——它本身不编译也不烧录但能通过调试适配器对接ST-Link在VS Code里实现打断点、看寄存器、看变量值这些操作。STM32 VS Code Extension是ST官方出的插件把STM32CubeMX生成的工程直接对接进VS Code能一键构建、烧录。对新手来说这个插件把很多命令行操作封装成了按钮体验很友好。不过它对工程结构有一定要求必须是CubeMX或STM32CubeIDE生成的Makefile/CMake工程老的Keil移植工程就不能直接用。3.2 辅助扩展按需装别全都上除了上面五个还有几个我用过之后觉得“特定场景下非常好用”的扩展你可以根据自己的项目情况决定要不要加Arm Assembly提供STM32汇编启动文件.s的语法高亮和智能提示。如果你会看启动文件定位问题建议装。LinkerScript给.ld链接脚本提供语法高亮和代码补全。做Bootloader或者自定义内存分配时必装。GitLens查看每行代码的提交历史。如果有Git版本管理习惯强烈推荐如果目前还是复制粘贴存版本可以先不装。Remote - SSH如果你的编译环境在Linux服务器上或者树莓派上做了交叉编译这个扩展能把整个VS Code搬到远程环境用。不是纯本地开发的话很有用。我的原则是扩展装得越少启动越快右下角弹错误通知的概率越低。等你真正需要某项功能时再装比一次性装二十个最后不知道哪个在拖慢编辑器更省心。3.3 扩展市场打不开或下载慢怎么办这是国内用户很容易遇到的问题。如果你打开扩展面板后一直转圈加载不出列表甚至提示“Extensions view is unavailable”先不要怀疑是VS Code坏了。最稳妥的办法是去VS Code扩展市场官网直接搜扩展名在页面右侧找到“Download Extension”按钮下载一个.vsix文件。然后在VS Code扩展面板右上角点击“...”按钮选择“从VSIX安装”选中下载好的文件即可。这个方法完全绕开了扩展市场内的网络加载问题而且可以装到指定版本适合公司内网环境。另外注意VS Code有两个容易混淆的市场。默认用的是Visual Studio Marketplace下载vsix时认准marketplace.visualstudio.com这个官方地址。有些开源版编辑器用的是Open VSX Registry格式一般也兼容但优先用官方市场最稳。4. 补上编译器、烧录器和调试器让VS Code真正能用4.1 安装GNU Arm Embedded Toolchain并验证VS Code本身不写代码、不编译代码它的一切能力都靠外部工具支撑。所以装完VS Code和扩展你还缺一个真正的编译器。目前STM32工程的主流命令行编译器是GNU Arm Embedded Toolchain也就是常说的arm-none-eabi-gcc。去Arm官网的GNU Toolchain下载页面选择Windows版本。注意一下安装后要把工具链的bin目录加进系统PATH安装器一般会问确认勾选“Add path to environment variable”之类的选项就行。装完打开VS Code的终端输入arm-none-eabi-gcc -v如果能看到以gcc version开头、带有arm-none-eabi字样的输出说明工具链安装成功。这一步卡住的人最多九成原因是PATH没生效重启一下VS Code或者重启电脑就好。4.2 用STM32CubeMX生成Makefile工程有了编译器你还得有一个能被命令行调用的工程结构。老一批朋友的习惯是Keil工程但Keil的工程文件是.uvprojxVS Code这边没法直接编译。我的建议是以后新开项目统一走STM32CubeMX生成Makefile工程的路子。在STM32CubeMX里配置好芯片型号、时钟树、引脚功能后在Project Manager页面里把“Toolchain / IDE”选成Makefile然后点击生成代码。生成出来的文件夹里会有Makefile、Core/、Drivers/这些标准结构这个工程就是VS Code能直接用的了。这里有个小细节生成工程时把项目路径选到一个没有中文、没有空格的目录下比如D:\projects\stm32_ai_demo。后面编译时你会感谢这个决定的。4.3 配置C/C的IntelliSense让它能找到头文件用VS Code打开生成好的工程文件夹此时代码可能已经有补全了但不一定准确。C/C扩展需要知道三件事头文件路径、编译宏定义、编译器路径。这些配置放在.vscode/c_cpp_properties.json里。一个常见的STM32F103工程的配置长这样{ configurations: [ { name: STM32, includePath: [ ${workspaceFolder}/**, ${workspaceFolder}/Core/Inc, ${workspaceFolder}/Drivers/STM32F1xx_HAL_Driver/Inc, ${workspaceFolder}/Drivers/CMSIS/Device/ST/STM32F1xx/Include, ${workspaceFolder}/Drivers/CMSIS/Include ], defines: [ USE_HAL_DRIVER, STM32F103xB ], compilerPath: C:/Program Files (x86)/Arm GNU Toolchain arm-none-eabi/13.2 Rel1/bin/arm-none-eabi-gcc.exe, cStandard: c11 } ], version: 4 }这里最容易漏的是defines配置。STM32的HAL库源码大量使用条件编译比如USE_HAL_DRIVER和芯片型号宏STM32F103xB如果不定义头文件里很多声明会被#ifndef跳过去IntelliSense就会报“找不到某某函数”或“头文件无法打开”。这种报错不是编译器问题纯属IntelliSense配置问题。配置完c_cpp_properties.jsonVS Code一般会自动重新扫描红色的波浪线会少一大半。如果没反应CtrlShiftP打开命令面板输入“C/C: Reset IntelliSense Database”重置一下索引。4.4 一键编译配置tasks.json工程是Makefile结构了在VS Code里编译就简单了。CtrlShiftP输入“Configure Default Build Task”选择“Create tasks.json file from template”然后选“Others”把内容替换成这样{ version: 2.0.0, tasks: [ { label: build, type: shell, command: make, args: [ -j8 ], group: { kind: build, isDefault: true }, problemMatcher: [ $gcc ] } ] }保存后按下CtrlShiftB终端里就会跑make -j8。如果刚才工具链和工程都没问题编译结果会在终端里显示。出现text段、data段的大小统计最后几行没有Error字样就是编译通过了。-j8是并行编译参数含义是同时用8个线程编译电脑核心多的话编译速度会快很多。笔记本性能弱一点的改成-j4即可。problemMatcher配置为$gcc后编译报错可以直接在“问题”面板里点跳转到出错行比在终端里翻日志方便许多。4.5 一键烧录STM32CubeProgrammer命令行烧录可以用STM32CubeProgrammer的图形界面但既然都在VS Code里写代码了干脆把它也做成一个任务。先安装STM32CubeProgrammer找到CLI工具路径通常在这C:\Program Files\STMicroelectronics\STM32Cube\STM32CubeProgrammer\bin\STM32_Programmer_CLI.exe然后在tasks.json里再加一个烧录任务{ label: flash, type: shell, command: C:/Program Files/STMicroelectronics/STM32Cube/STM32CubeProgrammer/bin/STM32_Programmer_CLI.exe, args: [ -c, portSWD, modeHOTPLUG, -w, ${workspaceFolder}/build/stm32_ai_demo.hex, -v ] }${workspaceFolder}是VS Code自动替换的当前工程目录后面的build/stm32_ai_demo.hex要改成你自己的固件实际输出路径。-c portSWD modeHOTPLUG意思是使用SWD接口连接自动探测目标板-w指定要烧录的文件-v是烧录后校验。配好之后CtrlShiftP运行“Tasks: Run Task”选flash板载LED闪两下烧录就成功了。不用在命令行里敲长串命令也不用切到Keil里点下载按钮整个流程都在VS Code里完成。4.6 Cortex-Debug在线调试配置在线调试这件事很多人还是习惯Keil里点“Start Debug Session”。实际上Cortex-Debug在VS Code里的体验不差关键是launch.json要配对。在.vscode/launch.json里写这样一个配置{ version: 0.2.0, configurations: [ { name: Cortex Debug, cwd: ${workspaceFolder}, executable: ${workspaceFolder}/build/stm32_ai_demo.elf, request: launch, type: cortex-debug, servertype: openocd, device: STM32F103C8, configFiles: [ interface/stlink.cfg, target/stm32f1x.cfg ] } ] }servertype用的是OpenOCD所以还要装一个OpenOCD把OpenOCD的bin目录配到PATH里。configFiles里的interface/stlink.cfg对应ST-Link适配器target/stm32f1x.cfg对应你的芯片系列根据型号换成stm32f4x.cfg、stm32l4x.cfg等。配置好后按F5Cortex-Debug会自动拉起OpenOCD连接到板子在main函数处停下此时左边面板就能看外设寄存器、变量值和调用栈了。需要注意生成的固件路径必须是.elf文件不是.hex因为调试器需要符号表才能把地址映射成源码行。5. 接入AI编程插件我切换Continue加DeepSeek的过程5.1 嵌入式场景选AI插件我看重这三点VS Code里的AI编程插件多到数不清但嵌入式开发的选型标准和纯做网页前端的完全不一样。我个人只关注三点第一能不能解释硬件相关代码。STM32的工程里有大量寄存器结构体、中断向量表、链接脚本AI插件如果只是套用通用代码库看了这些会直接胡编。必须选一个上下文能力强的模型且能同时看到当前文件和工程里的头文件定义。第二模型服务延迟要低。嵌入式调试时经常是打断点看变量突然想到一个疑问就切到对话窗口问一句如果等十几秒才回复后面就不太想用了。第三模型得能“看见”整个工程结构问问题时要带上当前文件、选中的代码片段甚至错误信息。5.2 Continue安装配置支持本地和云端模型我目前的主力方案是Continue.dev开源插件它本身是个免费的VS Code扩展支持接入云端API或本地模型。之所以推荐它是因为配置逻辑非常透明——所有的模型接入都写在continue.config.json里不怕厂商锁定以后想换模型改配置就行。安装好Continue后打开设置里的配置文件加入DeepSeek的provider。DeepSeek的API和OpenAI兼容接口地址默认就是这样{ models: [ { title: DeepSeek, provider: deepseek, model: deepseek-chat, apiBase: https://api.deepseek.com/v1, apiKey: 你的密钥 } ] }配置好后在Continue面板里选DeepSeek模型就可以开始对话了。如果你不想用云端API也可以选本地模型比如Qwen系列的小模型通过Ollama跑在本地配置方式类似只是把provider换成ollama模型名换成你自己拉取的模型即可。本地模型的好处是代码不出机器对公司和学校网络环境更友好但需要一台16G内存以上的机器才跑得动7B左右的模型。5.3 实战让AI生成STM32初始化代码环境配好后的第一件事我建议你试一个具体的AI编程场景让AI生成一段STM32的GPIO初始化代码验证整个链路是否通畅。比如在对话框里输入使用STM32F103C8T6的HAL库初始化PA1和PA2为推挽输出模式初始电平为高GPIO速度为50MHz。我的要求是让Continue结合当前工程的HAL库头文件来分析不要凭空虚编。如果配置正常它会给出类似这样的代码GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitStruct.Pin GPIO_PIN_1 | GPIO_PIN_2; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, GPIO_InitStruct); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1 | GPIO_PIN_2, GPIO_PIN_SET);这段代码放在你当前工程里只要头文件路径没配错IntelliSense应该马上把GPIO_InitTypeDef、GPIO_MODE_OUTPUT_PP这些符号高亮成可跳转状态说明AI生成的代码能直接衔接当前工程环境。这一步跑通你后面用AI写UART、I2C、PWM初始化代码时就心里有底了。5.4 嵌入式AI编程的边界我会信它五成剩下五成自己验AI编程确实能提效但用在嵌入式上要特别留个心眼。我的习惯是AI生成的代码先让它解释每一步的原理再对照芯片手册确认时钟和引脚配置最后烧到板子上实测一遍。原因很简单嵌入式代码出问题不像Web应用只是报个500错误它可能让电机乱转、让板子冒烟。具体到场景代码补全、结构体字段填充、API调用这类“填空式”任务AI的准确率很高基本能直接信。寄存器配置、中断优先级、DMA请求映射这类“参数敏感”的任务我会重点检查因为这些值错了编译器不会报错但硬件运行时会非常诡异。涉及外设时序、电气特性、PCB引脚选型这些硬件物理层面的问题AI基本没有判断力别指望它。6. 环境装完最容易翻车的四个坑替你试过了6.1 中文路径和空格目录这是我在帮别人配环境时遇到最多的问题。STM32CubeMX生成的工程只要路径里有中文名比如D:\学习\stm32项目\到make编译那一步就会报出各种离谱错误什么No such file or directory、recipe for target failed有时候甚至找不到源文件。解决办法最简单——工程路径全部用英文目录层级里不要带空格。D:\projects\timer_pwm_demo这种格式最稳妥。已经配了中文路径的推荐重新生成一次工程别想着改个文件夹名糊弄过去Git、Make、OpenOCD这串工具基本都是对着路径做字符串匹配的半路出问题排查起来更痛苦。6.2 IntelliSense报错但编译却通过这个现象特别迷惑VS Code里满屏红色波浪线提示“无法打开源文件”“未定义标识符”但CtrlShiftB一编译一点错误都没有固件照常生成。原因是IntelliSense的配置和Makefile的编译参数对不上。Makefile里通过-I参数指定头文件路径、通过-D定义宏但IntelliSense不看Makefile它只认c_cpp_properties.json里的includePath和defines。两边配置不匹配就会出现这种报错。解决办法是把c_cpp_properties.json里的includePath覆盖到Makefile里用到的所有头文件目录defines里把Makefile里的-DUSE_HAL_DRIVER -DSTM32F103xB这类宏原样写进去。还有一种省事的方法在c_cpp_properties.json里把configurationProvider设置为ms-vscode.makefile-tools让Makefile Tools插件去解析Makefile的编译参数IntelliSense就能自动对齐。6.3 ST-Link被占用或驱动异常点了烧录任务后报错Error: ST-LINK error (DEVICE_NOT_SUPPORTED)或者No ST-LINK detected大多数时候不是板子坏了而是ST-Link被另一个程序占着。最典型的场景是Keil和STM32CubeProgrammer同时开着或者上一次调试没正常退出ST-Link还被“挂起”。解决办法是把Keil、STM32CubeProgrammer、OpenOCD这些可能占用ST-Link的程序全部关掉然后拔插一下开发板的USB线。如果还不行就在设备管理器里看有没有“STLink dongle”且带了黄色感叹号有的话重新安装一下ST-Link驱动。这里提醒一句顺序是先关占用程序再拔插USB最后重装驱动别反着来不然容易反复触发未签名驱动提示。6.4 调试断点失效或变量不读取Cortex-Debug装好后F5能连上芯片但断点打在某个函数里根本不触发或者变量窗口显示not available。这个问题九成出在编译优化等级上。STM32CubeMX默认生成的Makefile里优化等级通常是-Og这是“调试体验优先”的等级。但如果你自己改过编译参数或者从网上拉的工程模板里用了-O2编译器会把代码做大量优化变量可能被优化掉不在内存中代码行和实际执行的指令对不上——断点自然就失效了。调试阶段建议把Makefile里的OPT参数固定为-Og或-O0确认能跑通调试链路后再考虑改成-O2去压性能和体积。我个人习惯是开发阶段一直用-Og最后发布前再切换优化等级重新编译测一测这样变量和断点的可读性最好。这套环境搭完我日常最舒服的工作流就是CubeMX生成工程、VS Code里写代码、Continue帮忙补全和解释、CtrlShiftB编译、一键任务烧录、F5断点调试AI几乎嵌在了每个环节里。到现在我仍然不觉得AI能替代嵌入式工程师的判断但它确实把大量“跳来跳去查头文件定义、翻手册找寄存器参数”的时间压缩到了极短。如果你也正卡在环境配置这一步我最想提醒你的一点是安装不是目的跑通一个能编译、能烧录、还能让AI帮你写代码的闭环才是这次折腾的真正意义。 
长河君 · 2026/9/15 1:18:13 · 阅读 1.2k STM32开发环境迁移：VS Code + AI编程插件完整配置指南
我大概是在好几个STM32项目里被Keil的编辑器折磨到没脾气之后才下定决心把整个开发流程迁到VS Code的。说句实在话Keil的编译和调试确实稳但那个写代码的体验和现代编辑器之间差着整整一个时代。这个系列叫“嵌入式软件AI编程”第07篇的核心任务是给STM32开发环境装好VS Code和配套扩展工具——听起来好像就是个安装教程但真做起来从版本选择、插件筛选、编译器搭配到AI插件接入每一步都有讲究。尤其是你打算用AI来辅助写代码时编辑器和工具链选得对不对会直接影响你后面几个月的开发顺不顺。这篇环境安装教程主要面向正在入门STM32、准备尝试AI辅助开发但之前一直用Keil或者其他老旧IDE的工程师和同学。我默认你已经有一块能用的STM32板子最好是带板载ST-Link的Nucleo或类似开发板这样烧录和调试部分可以直接跟着做。下面从头到尾走一遍包括我踩过的坑和最后留下的习惯配置。1. 替换Keil不是件小事为什么非要为AI编程重整开发环境1.1 Keil编辑器真正缺的是什么先说结论如果你的目标是“写代码更顺手、让AI能帮你写代码”Keil的编辑器本身是硬瓶颈这不是换换主题、装个插件能解决的。Keil用的还是老一套的代码编辑模型。代码自动补全能力很弱很多时候只提示到函数名、变量名的程度结构体成员、宏定义展开、模板代码这些基本指望不上。语义高亮也粗糙代码一多整个文件就像一块贴满便签的白板扫一眼根本找不到关键逻辑。更麻烦的是Keil没有真正意义上的插件生态外面那些AI编程工具比如通义灵码、CodeGeeX、Continue几乎全部优先支持VS CodeKeil根本不在它们的适配名单里。换句话说你希望AI帮你补全代码、解释报错、生成初始化逻辑第一步不是找AI工具而是先把编辑器换成AI工具能落地的环境。VS Code就是目前承载嵌入式AI编程最好的宿主。1.2 VS Code AI插件能带来的实际变化我自己的体感是这样换到VS Code之后代码补全从“关键词级提示”变成“语义级补全”。装了C/C扩展并正确配置IntelliSense后输入HAL_GPIO_WritePin它会根据你include的头文件和宏定义把参数都列出来甚至能提示传入的GPIO引脚名。这个体验Keil里很难实现。再加上AI插件后变化更直接。比如我想初始化一个定时器以前要么翻手册查寄存器要么从旧工程复制一份再改参数。现在直接在对话面板里说一句“用STM32F103的TIM2输出两路PWM频率20kHz占空比50%”AI会生成完整配置代码我检查一遍时钟树和引脚号之后粘进工程基本就能跑。这个流程极大压缩了从查手册到写代码的时间。1.3 这套环境能做什么、不能做什么我得先把预期管理好避免你装完环境后发现“也没那么神”。这套环境能做的事很清楚在VS Code里看代码、写代码、补全代码一键编译工程一键烧录固件到STM32在线断点调试通过AI插件做代码生成、解释、审查。这些都能稳定跑通。但它不能替代你理解芯片本身。AI生成代码时如果你不懂GPIO模式、定时器时钟分频、DMA请求映射这些基础概念很难判断生成结果是不是对的。环境只是工具芯片手册和硬件调试能力还是得自己长在身上。2. 安装VS Code选版本、勾选项和第一次启动要干的活2.1 下载哪个安装包User Installer优先去VS Code官网下载时会看到两个Windows版本User Installer和System Installer。我的建议是如果你用的是自己日常办公的电脑且只有一个Windows账户优先选User Installer。它不需要管理员权限装在用户目录下后续手动更新也好、装扩展也好基本不会遇到UAC弹窗拦路。如果是在公司配发的电脑上装或者你经常需要切换多个Windows账户共用这台机器那就选System Installer装到Program Files所有用户都能用。安装过程没什么特别一路Next也行。但我不建议直接无脑Next下面几个选项值得单独确认。2.2 安装向导里的关键勾选安装向导中间有一个“选择附加任务”的页面很多人扫一眼就跳过了其实这里藏着三个后续会省很多事的东西添加到PATH这个必须勾。只有勾了你之后在终端里才能直接输入code命令打开VS Code很多教程和脚本都依赖这个命令。添加到“打开方式”列表和文件夹右键菜单建议勾上。你以后在资源管理器里右键一个.c文件或者右键一个工程目录直接就能用VS Code打开不用先开编辑器再去找文件。注册为支持的文件类型编辑器可勾可不勾。如果勾了以后双击.c、.h文件会默认用VS Code打开Keil项目里的源码文件也会受影响。这个看个人习惯我喜欢保留Keil双击打开所以没勾。安装完成后建议先别急着装插件打开VS Code第一件事确认左下角显示的版本号。等以后排查插件兼容性问题时版本信息通常最先用到。2.3 第一次启动要干的活中文、自动保存、字体VS Code默认是全英文界面。除非你英文阅读毫无障碍否则我建议顺手把中文语言包装上。打开扩展面板左侧边栏的方块图标搜索“Chinese”找到微软出的“中文简体语言包”安装后右下角会提示重启重启后界面就是中文了。接下来改几个编辑器的基础设置。按Ctrl ,打开设置界面建议优先改这几项Auto Save自动保存把“files.autoSave”改成afterDelay延迟时间设成1000毫秒。嵌入式工程里你写代码时经常忘记按保存就去编译编译出来还是旧代码排查半天才发现没保存。自动保存能省掉这个低级错误。Editor: Font Size字体大小我自己用16px长时间看不累。推荐14~16之间。Editor: Tab Size缩进尺寸STM32的C代码风格以4空格缩进为主把Tab Size设为4同时勾选“Detect Indentation”取消掉避免它根据文件内容自动切换。Word Wrap自动换行改成on否则注释写长了会横向滚动看着很难受。这些属于“谁装完环境都会做”的基础设置做完了再去碰编译链和插件才不容易被界面问题打断思路。3. STM32扩展工具清单五个必装三个按需装VS Code强在扩展生态但生态丰富也意味着容易选择困难。我重新整理过自己几台电脑上的扩展列表精简掉了不少“看着有用实际吃灰”的插件。针对STM32开发核心就五件套。3.1 五个必装扩展分别解决什么问题下面这几个扩展是我每次新装环境时必装的少一个都会别扭扩展发布者作用C/CMicrosoft代码补全、智能提示、符号跳转、调试支持IntelliSense核心Cortex-DebugMarus通过OpenOCD、ST-Link等对ARM Cortex-M芯片进行在线调试STM32 VS Code ExtensionSTMicroelectronicsST官方插件可配合STM32CubeMX创建工程、一键构建并烧录Embedded ToolsMicrosoft嵌入式开发辅助工具提供嵌入式项目的工程管理和语法识别能力Chinese语言包中文界面插件Microsoft界面中文化降低使用门槛这里重点说下C/C扩展和Cortex-Debug的分工。C/C负责的是“读代码”这一侧——它扫描整个工程里的头文件、宏定义和源码路径建立起符号索引让你能跳转定义、看到变量类型、补全成员。Cortex-Debug负责的是“调试”这一侧——它本身不编译也不烧录但能通过调试适配器对接ST-Link在VS Code里实现打断点、看寄存器、看变量值这些操作。STM32 VS Code Extension是ST官方出的插件把STM32CubeMX生成的工程直接对接进VS Code能一键构建、烧录。对新手来说这个插件把很多命令行操作封装成了按钮体验很友好。不过它对工程结构有一定要求必须是CubeMX或STM32CubeIDE生成的Makefile/CMake工程老的Keil移植工程就不能直接用。3.2 辅助扩展按需装别全都上除了上面五个还有几个我用过之后觉得“特定场景下非常好用”的扩展你可以根据自己的项目情况决定要不要加Arm Assembly提供STM32汇编启动文件.s的语法高亮和智能提示。如果你会看启动文件定位问题建议装。LinkerScript给.ld链接脚本提供语法高亮和代码补全。做Bootloader或者自定义内存分配时必装。GitLens查看每行代码的提交历史。如果有Git版本管理习惯强烈推荐如果目前还是复制粘贴存版本可以先不装。Remote - SSH如果你的编译环境在Linux服务器上或者树莓派上做了交叉编译这个扩展能把整个VS Code搬到远程环境用。不是纯本地开发的话很有用。我的原则是扩展装得越少启动越快右下角弹错误通知的概率越低。等你真正需要某项功能时再装比一次性装二十个最后不知道哪个在拖慢编辑器更省心。3.3 扩展市场打不开或下载慢怎么办这是国内用户很容易遇到的问题。如果你打开扩展面板后一直转圈加载不出列表甚至提示“Extensions view is unavailable”先不要怀疑是VS Code坏了。最稳妥的办法是去VS Code扩展市场官网直接搜扩展名在页面右侧找到“Download Extension”按钮下载一个.vsix文件。然后在VS Code扩展面板右上角点击“...”按钮选择“从VSIX安装”选中下载好的文件即可。这个方法完全绕开了扩展市场内的网络加载问题而且可以装到指定版本适合公司内网环境。另外注意VS Code有两个容易混淆的市场。默认用的是Visual Studio Marketplace下载vsix时认准marketplace.visualstudio.com这个官方地址。有些开源版编辑器用的是Open VSX Registry格式一般也兼容但优先用官方市场最稳。4. 补上编译器、烧录器和调试器让VS Code真正能用4.1 安装GNU Arm Embedded Toolchain并验证VS Code本身不写代码、不编译代码它的一切能力都靠外部工具支撑。所以装完VS Code和扩展你还缺一个真正的编译器。目前STM32工程的主流命令行编译器是GNU Arm Embedded Toolchain也就是常说的arm-none-eabi-gcc。去Arm官网的GNU Toolchain下载页面选择Windows版本。注意一下安装后要把工具链的bin目录加进系统PATH安装器一般会问确认勾选“Add path to environment variable”之类的选项就行。装完打开VS Code的终端输入arm-none-eabi-gcc -v如果能看到以gcc version开头、带有arm-none-eabi字样的输出说明工具链安装成功。这一步卡住的人最多九成原因是PATH没生效重启一下VS Code或者重启电脑就好。4.2 用STM32CubeMX生成Makefile工程有了编译器你还得有一个能被命令行调用的工程结构。老一批朋友的习惯是Keil工程但Keil的工程文件是.uvprojxVS Code这边没法直接编译。我的建议是以后新开项目统一走STM32CubeMX生成Makefile工程的路子。在STM32CubeMX里配置好芯片型号、时钟树、引脚功能后在Project Manager页面里把“Toolchain / IDE”选成Makefile然后点击生成代码。生成出来的文件夹里会有Makefile、Core/、Drivers/这些标准结构这个工程就是VS Code能直接用的了。这里有个小细节生成工程时把项目路径选到一个没有中文、没有空格的目录下比如D:\projects\stm32_ai_demo。后面编译时你会感谢这个决定的。4.3 配置C/C的IntelliSense让它能找到头文件用VS Code打开生成好的工程文件夹此时代码可能已经有补全了但不一定准确。C/C扩展需要知道三件事头文件路径、编译宏定义、编译器路径。这些配置放在.vscode/c_cpp_properties.json里。一个常见的STM32F103工程的配置长这样{ configurations: [ { name: STM32, includePath: [ ${workspaceFolder}/**, ${workspaceFolder}/Core/Inc, ${workspaceFolder}/Drivers/STM32F1xx_HAL_Driver/Inc, ${workspaceFolder}/Drivers/CMSIS/Device/ST/STM32F1xx/Include, ${workspaceFolder}/Drivers/CMSIS/Include ], defines: [ USE_HAL_DRIVER, STM32F103xB ], compilerPath: C:/Program Files (x86)/Arm GNU Toolchain arm-none-eabi/13.2 Rel1/bin/arm-none-eabi-gcc.exe, cStandard: c11 } ], version: 4 }这里最容易漏的是defines配置。STM32的HAL库源码大量使用条件编译比如USE_HAL_DRIVER和芯片型号宏STM32F103xB如果不定义头文件里很多声明会被#ifndef跳过去IntelliSense就会报“找不到某某函数”或“头文件无法打开”。这种报错不是编译器问题纯属IntelliSense配置问题。配置完c_cpp_properties.jsonVS Code一般会自动重新扫描红色的波浪线会少一大半。如果没反应CtrlShiftP打开命令面板输入“C/C: Reset IntelliSense Database”重置一下索引。4.4 一键编译配置tasks.json工程是Makefile结构了在VS Code里编译就简单了。CtrlShiftP输入“Configure Default Build Task”选择“Create tasks.json file from template”然后选“Others”把内容替换成这样{ version: 2.0.0, tasks: [ { label: build, type: shell, command: make, args: [ -j8 ], group: { kind: build, isDefault: true }, problemMatcher: [ $gcc ] } ] }保存后按下CtrlShiftB终端里就会跑make -j8。如果刚才工具链和工程都没问题编译结果会在终端里显示。出现text段、data段的大小统计最后几行没有Error字样就是编译通过了。-j8是并行编译参数含义是同时用8个线程编译电脑核心多的话编译速度会快很多。笔记本性能弱一点的改成-j4即可。problemMatcher配置为$gcc后编译报错可以直接在“问题”面板里点跳转到出错行比在终端里翻日志方便许多。4.5 一键烧录STM32CubeProgrammer命令行烧录可以用STM32CubeProgrammer的图形界面但既然都在VS Code里写代码了干脆把它也做成一个任务。先安装STM32CubeProgrammer找到CLI工具路径通常在这C:\Program Files\STMicroelectronics\STM32Cube\STM32CubeProgrammer\bin\STM32_Programmer_CLI.exe然后在tasks.json里再加一个烧录任务{ label: flash, type: shell, command: C:/Program Files/STMicroelectronics/STM32Cube/STM32CubeProgrammer/bin/STM32_Programmer_CLI.exe, args: [ -c, portSWD, modeHOTPLUG, -w, ${workspaceFolder}/build/stm32_ai_demo.hex, -v ] }${workspaceFolder}是VS Code自动替换的当前工程目录后面的build/stm32_ai_demo.hex要改成你自己的固件实际输出路径。-c portSWD modeHOTPLUG意思是使用SWD接口连接自动探测目标板-w指定要烧录的文件-v是烧录后校验。配好之后CtrlShiftP运行“Tasks: Run Task”选flash板载LED闪两下烧录就成功了。不用在命令行里敲长串命令也不用切到Keil里点下载按钮整个流程都在VS Code里完成。4.6 Cortex-Debug在线调试配置在线调试这件事很多人还是习惯Keil里点“Start Debug Session”。实际上Cortex-Debug在VS Code里的体验不差关键是launch.json要配对。在.vscode/launch.json里写这样一个配置{ version: 0.2.0, configurations: [ { name: Cortex Debug, cwd: ${workspaceFolder}, executable: ${workspaceFolder}/build/stm32_ai_demo.elf, request: launch, type: cortex-debug, servertype: openocd, device: STM32F103C8, configFiles: [ interface/stlink.cfg, target/stm32f1x.cfg ] } ] }servertype用的是OpenOCD所以还要装一个OpenOCD把OpenOCD的bin目录配到PATH里。configFiles里的interface/stlink.cfg对应ST-Link适配器target/stm32f1x.cfg对应你的芯片系列根据型号换成stm32f4x.cfg、stm32l4x.cfg等。配置好后按F5Cortex-Debug会自动拉起OpenOCD连接到板子在main函数处停下此时左边面板就能看外设寄存器、变量值和调用栈了。需要注意生成的固件路径必须是.elf文件不是.hex因为调试器需要符号表才能把地址映射成源码行。5. 接入AI编程插件我切换Continue加DeepSeek的过程5.1 嵌入式场景选AI插件我看重这三点VS Code里的AI编程插件多到数不清但嵌入式开发的选型标准和纯做网页前端的完全不一样。我个人只关注三点第一能不能解释硬件相关代码。STM32的工程里有大量寄存器结构体、中断向量表、链接脚本AI插件如果只是套用通用代码库看了这些会直接胡编。必须选一个上下文能力强的模型且能同时看到当前文件和工程里的头文件定义。第二模型服务延迟要低。嵌入式调试时经常是打断点看变量突然想到一个疑问就切到对话窗口问一句如果等十几秒才回复后面就不太想用了。第三模型得能“看见”整个工程结构问问题时要带上当前文件、选中的代码片段甚至错误信息。5.2 Continue安装配置支持本地和云端模型我目前的主力方案是Continue.dev开源插件它本身是个免费的VS Code扩展支持接入云端API或本地模型。之所以推荐它是因为配置逻辑非常透明——所有的模型接入都写在continue.config.json里不怕厂商锁定以后想换模型改配置就行。安装好Continue后打开设置里的配置文件加入DeepSeek的provider。DeepSeek的API和OpenAI兼容接口地址默认就是这样{ models: [ { title: DeepSeek, provider: deepseek, model: deepseek-chat, apiBase: https://api.deepseek.com/v1, apiKey: 你的密钥 } ] }配置好后在Continue面板里选DeepSeek模型就可以开始对话了。如果你不想用云端API也可以选本地模型比如Qwen系列的小模型通过Ollama跑在本地配置方式类似只是把provider换成ollama模型名换成你自己拉取的模型即可。本地模型的好处是代码不出机器对公司和学校网络环境更友好但需要一台16G内存以上的机器才跑得动7B左右的模型。5.3 实战让AI生成STM32初始化代码环境配好后的第一件事我建议你试一个具体的AI编程场景让AI生成一段STM32的GPIO初始化代码验证整个链路是否通畅。比如在对话框里输入使用STM32F103C8T6的HAL库初始化PA1和PA2为推挽输出模式初始电平为高GPIO速度为50MHz。我的要求是让Continue结合当前工程的HAL库头文件来分析不要凭空虚编。如果配置正常它会给出类似这样的代码GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitStruct.Pin GPIO_PIN_1 | GPIO_PIN_2; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull GPIO_NOPULL; GPIO_InitStruct.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOA, GPIO_InitStruct); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_1 | GPIO_PIN_2, GPIO_PIN_SET);这段代码放在你当前工程里只要头文件路径没配错IntelliSense应该马上把GPIO_InitTypeDef、GPIO_MODE_OUTPUT_PP这些符号高亮成可跳转状态说明AI生成的代码能直接衔接当前工程环境。这一步跑通你后面用AI写UART、I2C、PWM初始化代码时就心里有底了。5.4 嵌入式AI编程的边界我会信它五成剩下五成自己验AI编程确实能提效但用在嵌入式上要特别留个心眼。我的习惯是AI生成的代码先让它解释每一步的原理再对照芯片手册确认时钟和引脚配置最后烧到板子上实测一遍。原因很简单嵌入式代码出问题不像Web应用只是报个500错误它可能让电机乱转、让板子冒烟。具体到场景代码补全、结构体字段填充、API调用这类“填空式”任务AI的准确率很高基本能直接信。寄存器配置、中断优先级、DMA请求映射这类“参数敏感”的任务我会重点检查因为这些值错了编译器不会报错但硬件运行时会非常诡异。涉及外设时序、电气特性、PCB引脚选型这些硬件物理层面的问题AI基本没有判断力别指望它。6. 环境装完最容易翻车的四个坑替你试过了6.1 中文路径和空格目录这是我在帮别人配环境时遇到最多的问题。STM32CubeMX生成的工程只要路径里有中文名比如D:\学习\stm32项目\到make编译那一步就会报出各种离谱错误什么No such file or directory、recipe for target failed有时候甚至找不到源文件。解决办法最简单——工程路径全部用英文目录层级里不要带空格。D:\projects\timer_pwm_demo这种格式最稳妥。已经配了中文路径的推荐重新生成一次工程别想着改个文件夹名糊弄过去Git、Make、OpenOCD这串工具基本都是对着路径做字符串匹配的半路出问题排查起来更痛苦。6.2 IntelliSense报错但编译却通过这个现象特别迷惑VS Code里满屏红色波浪线提示“无法打开源文件”“未定义标识符”但CtrlShiftB一编译一点错误都没有固件照常生成。原因是IntelliSense的配置和Makefile的编译参数对不上。Makefile里通过-I参数指定头文件路径、通过-D定义宏但IntelliSense不看Makefile它只认c_cpp_properties.json里的includePath和defines。两边配置不匹配就会出现这种报错。解决办法是把c_cpp_properties.json里的includePath覆盖到Makefile里用到的所有头文件目录defines里把Makefile里的-DUSE_HAL_DRIVER -DSTM32F103xB这类宏原样写进去。还有一种省事的方法在c_cpp_properties.json里把configurationProvider设置为ms-vscode.makefile-tools让Makefile Tools插件去解析Makefile的编译参数IntelliSense就能自动对齐。6.3 ST-Link被占用或驱动异常点了烧录任务后报错Error: ST-LINK error (DEVICE_NOT_SUPPORTED)或者No ST-LINK detected大多数时候不是板子坏了而是ST-Link被另一个程序占着。最典型的场景是Keil和STM32CubeProgrammer同时开着或者上一次调试没正常退出ST-Link还被“挂起”。解决办法是把Keil、STM32CubeProgrammer、OpenOCD这些可能占用ST-Link的程序全部关掉然后拔插一下开发板的USB线。如果还不行就在设备管理器里看有没有“STLink dongle”且带了黄色感叹号有的话重新安装一下ST-Link驱动。这里提醒一句顺序是先关占用程序再拔插USB最后重装驱动别反着来不然容易反复触发未签名驱动提示。6.4 调试断点失效或变量不读取Cortex-Debug装好后F5能连上芯片但断点打在某个函数里根本不触发或者变量窗口显示not available。这个问题九成出在编译优化等级上。STM32CubeMX默认生成的Makefile里优化等级通常是-Og这是“调试体验优先”的等级。但如果你自己改过编译参数或者从网上拉的工程模板里用了-O2编译器会把代码做大量优化变量可能被优化掉不在内存中代码行和实际执行的指令对不上——断点自然就失效了。调试阶段建议把Makefile里的OPT参数固定为-Og或-O0确认能跑通调试链路后再考虑改成-O2去压性能和体积。我个人习惯是开发阶段一直用-Og最后发布前再切换优化等级重新编译测一测这样变量和断点的可读性最好。这套环境搭完我日常最舒服的工作流就是CubeMX生成工程、VS Code里写代码、Continue帮忙补全和解释、CtrlShiftB编译、一键任务烧录、F5断点调试AI几乎嵌在了每个环节里。到现在我仍然不觉得AI能替代嵌入式工程师的判断但它确实把大量“跳来跳去查头文件定义、翻手册找寄存器参数”的时间压缩到了极短。如果你也正卡在环境配置这一步我最想提醒你的一点是安装不是目的跑通一个能编译、能烧录、还能让AI帮你写代码的闭环才是这次折腾的真正意义。