1. 动手前的准备：为什么你把AI当成搜索引擎用，却写不好STM32工程
先聊点实际的。很多人一说AI编程，第一反应是打开对话框，把需求打过去，复制代码，粘贴进Keil，然后编译报错，再复制报错回给AI，来回拉扯半天。这个流程不能说错，但在嵌入式里，尤其是STM32这种和硬件强相关的开发里，效率极低，而且经常把整个工程搞成一坨浆糊。
问题出在哪？出在你还没搞清楚AI编程和纯软件AI编程的本质差异。写网页、写Python脚本，AI输出的代码拿过来基本能跑，大不了调一下依赖版本。但STM32不一样，你的代码是跑在具体芯片上的，引脚对不对、时钟配没配、外设初始化顺序对不对、固件库版本匹不匹配，任何一个环节脱节，代码再漂亮也白搭。AI看不到你的原理图，看不到你的板子，更不知道你手里那根杜邦线到底插在哪个引脚上。它产出的东西更像是一个经验丰富的同事在你旁边口述建议，而不是一个能包办一切的影子工程师。
所以，这一篇我打算换个思路。不按“打开CubeMX、点几下、生成代码”这种保姆级教程写，而是按一个正常工程师的做事顺序来：先明确你要做的东西是什么，再想清楚哪部分靠AI、哪部分靠工具自动生成、哪部分必须你自己判断，最后才落到具体操作。目标是让你走完一遍之后，能自己搭出一个结构不混乱、能编译、能下载、能调通的第一个STM32工程，并且以后做第二个、第三个工程时，不用再从头摸索。
先说我自己的环境，方便你对照。芯片用的是STM32F103C8T6，也就是网上烂大街的“蓝丸”核心板。IDE是Keil MDK 5.39，固件库用的是HAL库，代码生成工具是STM32CubeMX 6.10，下载器是ST-Link V2。这套组合是目前新手资料最多、出问题最好查的配置。你要是用的是标准库，或者用VSCode + EIDE，或者干脆用IAR，核心逻辑是一样的，我就不重复了。
先立个目标，今天这第一个工程，不搞花活，就是一个跑马灯：上电后板载的三个LED轮流亮，每200ms切换一次。听起来简单，但走完这一趟，你就能摸清AI辅助嵌入式开发的完整套路。
2. 选型定调：CubeMX + HAL库 + AI提示词，这三者的分工到底是什么
2.1 为什么我用CubeMX生成初始化，而不是让AI直接写
这是第一个该想明白的问题。你完全可以让AI写一段GPIO初始化的代码，它写得出来，而且写得不错。但问题在于初始化代码不是孤立的，它依赖时钟树、依赖中断优先级分组、依赖芯片头文件里的寄存器定义，这些东西AI没法凭空猜准。
官方给出的标准姿势是：用STM32CubeMX这种图形化工具，把引脚分配、时钟频率、外设模式这些硬件相关的东西可视化配置好，然后让它生成初始化代码框架。CubeMX生成的代码是基于HAL库的，层次清楚、命名规范、不容易踩坑，这也是ST官方推荐的做法。
那AI在哪儿起作用？在业务逻辑层。GPIO怎么初始化交给CubeMX，但LED轮播的顺序、延时逻辑、按键消抖这些“纯逻辑”部分，才是AI出场的地方。把AI当成一个随叫随到的函数库顾问，而不是工程架构师，这是我用AI写嵌入式这段时间最重要的心得。
打个比方你就懂了。CubeMX是施工队，负责把地基和承重墙给你砌好，钢筋水泥标号它都给你配好。AI是监理，你在现场问他“这个墙角怎么收口”，他能给你说得很明白。但你非要让监理自己去砌墙，那就难免出幺蛾子。
2.2 标准库、HAL库、LL库，到底选哪个
聊到AI编程，这里就牵扯出一个绕不开的问题：AI训练数据里，哪个库的代码占比最大？
答案很明确：标准库。因为标准库在网上的历史资料最久，2010年到2020年这十年间大量教程、例程、毕业设计用的都是标准库，AI吃进去的训练语料自然以它为主。但你现在打开CubeMX，新版本默认生成的却是HAL库代码。
这就产生了一个矛盾：AI最拿手的是标准库，而当前主流的开发流程用的是HAL库。怎么办？
我的建议是：用HAL库，但让AI帮你把标准库的代码“翻译”成HAL版本。实操中特别管用。因为标准库和HAL库在逻辑上有很强的一一对应关系——标准库的GPIO_InitStructure对应HAL的GPIO_InitTypeDef，标准库的GPIO_SetBits对应HAL的HAL_GPIO_WritePin，你在提示词里明确说“请使用STM32 HAL库”并且提供你的芯片型号，AI完全能生成可用的代码。实测下来，只要你的需求足够具体，AI生成HAL代码的准确率能到八成以上，剩下两成编译报错也能很快修正。
如果你是非科班自学，或者项目对代码执行效率极其敏感，可以考虑LL库。但那是进阶话题，今天不展开。新手上路，HAL库是综合性价比最高的选择，资料多、抽象度高、和CubeMX配合完美。
2.3 选AI工具：不是越贵越好，顺手最重要
既然这一篇的主线是AI编程，那工具得说说。我目前在用的主力是Claude，代码生成质量在嵌入式领域确实能打，尤其对C语言的理解、对硬件层面细节的把握，比纯代码大模型更细腻。备选是ChatGPT，胜在通用性强，很多嵌入式社区的问题答案它都吃进去了。国内工具里，豆包和DeepSeek我也试过，日常问答和代码解释没问题，但涉及复杂工程配置、多文件联动时，深度还是差了一点。
这里必须强调一句：不管用哪家AI，都不要直接问“帮我写一个STM32跑马灯程序”，这种问法得到的答案是“教科书版”，能用但不够好。更好的问法是把你的工程现实约束丢给它，比如“STM32F103C8T6，HAL库，CubeMX生成的工程，三个LED分别接在PC13、PC14、PC15，高电平点亮，我要写一个轮播逻辑，200ms切换一次”。这种提示词喂出来的代码，几乎不需要改就能直接用。提示词模板我放在后面实操环节，照着抄就行。
另外提一句，如果你用的是VS Code + Cline这种带Agent能力的插件，那玩法又不太一样。Agent可以自己读文件、自己改代码、自己编译看报错，体验更接近“有个实习生在帮你干活”。不过第一次玩STM32，我建议还是先在网页版对话框里摸清套路，再上Agent，否则报错一多你根本分不清是AI的问题还是环境的问题。
3. 第一个STM32工程的完整实操：从点亮到轮播，全程AI协作
3.1 环境准备，避坑远大于安装
Keil MDK的安装没什么好说的，一路Next，网上教程一大堆。但有一个坑必须提醒你：Keil5安装完之后，默认是不带STM32芯片包的，你得去Keil官网下载对应的Device Family Pack，或者从Pack Installer里直接装。很多人编译的时候报错“Target not created”或者device列表里找不到STM32F103C8，九成是这一步漏了。
装好之后建议顺手验证一下下载器。ST-Link V2插上电脑，打开设备管理器，能看到一个“STLink dongle”的端口就说明驱动装好了。如果你用的是J-Link，那要注意Keil里的Flash Download设置，默认算法有时候不匹配，烧录会卡在“Cannot access target”。这个我后面在常见问题里会展开。
CubeMX那边，安装的时候会提示你下载固件库，建议等它下完，不然你新建工程的时候它现下会慢得让人抓狂。我用的是F1系列，固件包大概三百多兆，网速不好的时候提前下好很重要。
3.2 CubeMX配置：五分钟做完全部硬件初始化
打开CubeMX，新建工程，在Part Number搜索框输入STM32F103C8，双击选中。如果你看到的是带后缀的，比如STM32F103C8Tx，没关系，选那个就行，这是封装标识。
接下来的重点是Pinout & Configuration页面。你不用把每个外设都配置一遍，这第一个工程只需要用到一个东西：GPIO。
STM32F103C8T6的PC13引脚连接着板载LED，这是蓝丸板的标准接法。如果你的板子LED接在其他引脚，照着原理图改就行。我用的是三个LED，分别接PC13、PC14、PC15。在芯片图上左键点击PC13，在弹出的列表里选择GPIO_Output，同样操作PC14、PC15。你会看到这三个引脚变成绿色，这就代表配置好了。
然后去GPIO设置里，把三个引脚都设为Output Push Pull（推挽输出）、No pull-up and no pull-down（无上下拉）、Maximum output speed选Low就可以了。LED这种慢速外设，不需要High速度，选High反而可能引入信号完整性问题，虽然在这块板子上体现不出来，但养成好习惯总没错。
时钟配置页有个小技巧。默认情况下CubeMX用的是HSI内部时钟，主频只有8MHz，跑个LED无所谓，但后面跑串口、定时器、PWM就会出乱子。建议你在System Core -> RCC里，把HSE设为Crystal/Ceramic Resonator，然后在Clock Configuration页面里，把HCLK直接填成72，回车，CubeMX会自动帮你把PLL配好。这是F103最经典的超频配置，也是绝大多数教程和项目的标配，稳定得很。
最后在Project Manager页面，工程名随便起，比如led_blink，IDE选MDK-ARM V5（对应Keil5），Toolchain版本建议选5.26以上，底下的Minimum Firmware Package选F1最新版就行。设置完，右上角点GENERATE CODE，工程就生成好了。
3.3 AI提示词实战：我的三段式跑马灯写法
工程生成之后，用Keil打开，你会看到CubeMX已经帮你写好了main.c，里面有完整的GPIO初始化和一个空的while(1)循环。现在AI该上场了。
我的提示词三段式写法，第一段是交代背景，第二段是描述需求，第三段是限定约束，直接复制就能用：
背景：我在用STM32F103C8T6写一个LED轮播程序，用的HAL库，CubeMX已经配置好了PC13、PC14、PC15三个引脚为GPIO输出模式。 需求：写一个跑马灯逻辑，三个LED依次点亮，每次只亮一个，从左到右轮播，每200ms切换一次。 约束：代码写在while(1)循环里，使用HAL_GPIO_WritePin和HAL_Delay这两个HAL库函数，不要修改MX_GPIO_Init函数，不要额外引入定时器，代码要简洁。你看，这个提示词里每一个信息都不是多余的：芯片型号决定了可用的寄存器资源，HAL库决定了函数命名风格，引脚具体到编号是为了让AI不用猜，约束条件是为了让它别自作主张引入定时器或外部中断。AI拿到这个提示词，生成的代码基本长这样：
while (1) { HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET); HAL_GPIO_WritePin(GPIOC, GPIO_PIN_14|GPIO_PIN_15, GPIO_PIN_SET); HAL_Delay(200); HAL_GPIO_WritePin(GPIOC, GPIO_PIN_14, GPIO_PIN_RESET); HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13|GPIO_PIN_15, GPIO_PIN_SET); HAL_Delay(200); HAL_GPIO_WritePin(GPIOC, GPIO_PIN_15, GPIO_PIN_RESET); HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13|GPIO_PIN_14, GPIO_PIN_SET); HAL_Delay(200); }把这段复制到main.c的while(1)里，编译，0 error 0 warning。就这么简单。
哦对，这里有个细节必须说。HAL_GPIO_WritePin的第二个参数是引脚掩码，可以是多个引脚的按位或。所以“一次只亮一个，其他全灭”这个需求，用一行代码就能表达清楚，就是上面写的那样。新手容易踩的坑是先把三个引脚全部拉低，再拉高目标引脚，看着也行，但多了一次IO操作，而且在高频率轮播时LED会有一点肉眼可见的闪烁。AI直接给了最优解，这也是它训练数据多的好处。
3.4 编译下载：第一次烧录最好别用串口ISP
编译通过之后，点击下载按钮（快捷键F8），如果你用的是ST-Link，Keil默认会自动调用ST-Link的烧录算法。第一次烧录前，建议在Options for Target -> Debug里确认一下调试器选的是ST-Link，然后进Settings，看右上角能不能识别到SW Device。能识别到就说明连接正常，烧录大概率没问题。
不建议用的方式是串口ISP，也就是通过板载USB转串口芯片，配合Flash Loader Demonstrator或者FlyMcu去烧。不是说这个方式不能用，而是它对BOOT0跳线帽有要求，新手一不留神就搞成“程序下载进去但不跑”的状态。ST-Link走的SWD接口，不管BOOT引脚状态，直接烧直接跑，省心太多。
下载成功之后，你会看到板子上三个LED依次闪烁，每个200ms。恭喜，你的第一个STM32工程跑起来了。
4. 调试与排障：AI再强也扛不住玄学问题，你得学会这几招
4.1 最常见也是最好解决的：编译报错
编译报错分两类。一类是明显的语法错误，比如少了分号、括号没匹配，这种直接复制报错信息回给AI，它一眼就能看出来，改完就行。
另一类是配置类错误。比较经典的是“error: #5: cannot open source input file: stm32f1xx_hal.h: No such file or directory”。这个报错的根源不是你的代码有问题，而是Keil找不到HAL库的头文件路径。
CubeMX生成工程时，本来应该自动在C/C++选项卡的Include Paths里填好所有需要的头文件目录。但如果你用了旧版CubeMX、或者在生成后手动移动过工程目录，路径就会失效。解决办法是打开Options for Target -> C/C++，点Include Paths右边的省略号，把CubeMX生成的Inc文件夹路径手动加进去。
有意思的是，这类报错如果你直接复制给AI，它大概率会给你一个不明不白的答案，比如“检查头文件是否存在”。因为它看不到你的工程目录结构。这种问题的排查思路应该是“工程配置”而不是“代码逻辑”，AI在这类问题上帮助有限，自己动手反而更快。
4.2 编译过了但下载失败：目标设备连不上怎么办
下载失败的典型报错是“No Target Connected”或者“Cannot Access Target”。下面几个排查点按顺序过一遍，基本能解决九成的问题。
第一是接线。SWD只需要四根线：SWDIO、SWCLK、GND、3.3V。如果你用的是面包板加杜邦线，确认一下有没有插反，SWDIO对SWDIO、SWCLK对SWCLK，GND对GND，VCC对VCC。别笑，这真是我见过最多的低级错误。
第二是供电。蓝丸板子可以从USB口供电，但如果你把ST-Link也插着，两路电会打架。建议拔掉USB线，只用ST-Link给板子供3.3V，省去很多烦恼。
第三是烧录算法。Options for Target -> Utilities -> Settings，你会看到Flash Download里有一个Programming Algorithm列表。如果这里是空的，或者只有一个默认的STM32F10x High-density Flash，而你的芯片是Medium-density（C8T6就是），那烧录一定会失败。手动添加STM32F10x Medium-density 128K Flash，问题立刻解决。
你要是用的是J-Link，下载失败的原因通常是驱动版本太老，或者芯片被锁了。芯片被锁的解决办法是按住复位键不放，点击下载，然后在进度条出现的瞬间松开复位键。这个骚操作屡试不爽，原理是让芯片在下载命令发出时恰好处于复位状态，从而绕过读保护。
4.3 延时函数卡死的经典场景，也是AI最容易编瞎话的地方
我再额外讲一个经验。很多人在写第一个工程的时候不会只写跑马灯，总想加个按键控制，或者加个蜂鸣器。这时候你要是在中断服务函数里调用HAL_Delay，程序必定卡死。这是HAL库的经典坑：HAL_Delay依赖SysTick中断，如果一个更高优先级的中断一直在占据CPU，HAL_Delay的计数永远无法更新，就卡死了。
这种问题你拿去问AI，它的回答往往是“增加优先级分组配置”或者“别在中断里调用延时”——道理没错，但对新手来说没法落地。因为问题的根源是HAL库的设计机制，而不是代码逻辑。你想真正理解，就得回到中断优先级是怎么排序的、SysTick跑到哪个优先级、你的中断占了哪一级。这些底层知识，AI给不了你系统性的解释，你得自己去翻参考手册。
所以我的建议是：第一次上手，老老实实用CubeMX帮你配好的默认配置，别一上来就搞中断嵌套，别搞多优先级。先把跑马灯跑起来，把串口打通的快乐体会一遍，再慢慢加东西。
4.4 烧录成功但程序不运行：查BOOT引脚
最后一个高频问题。程序烧录成功了，Keil也不报错，但板子跑起来之后LED不闪，好像程序没在跑。排查顺序：先按一下板子上的复位键，看LED有没有反应；如果还不跑，看BOOT0跳线帽是不是被接到了1的位置。
BOOT0和BOOT1引脚决定芯片上电后从哪里启动。BOOT0=0时从Flash启动，这是正常运行模式；BOOT0=1时从系统存储器启动，会进入出厂Bootloader，你的程序自然不跑。蓝丸板子出厂时BOOT0默认是0，但之前用过串口ISP下载的话，有可能被改过。拿跳线帽拨回0，重新上电，就好了。
这类问题AI帮不上忙，它没法帮你检测硬件状态。但这恰恰是嵌入式开发的常态——你需要的不是更多AI，而是对硬件的敬畏和排查问题的耐心。
5. 让AI从“回答者”变成“协作者”：几个提示词模板和习惯
跑完第一个工程，你再回头看，会发现AI的角色其实很清晰：它不是替你写代码，而是陪你写代码。你的代码库里最花时间的部分，是理解需求、拆分功能、配置工程、定位错误，这些AI替代不了，但能从每个环节帮你提速。
最后分享几个我常用的AI提示词模板，都是踩过坑后总结出来的。
模板一：需求转方案。
我现在要实现[具体功能]，用的芯片是[型号]，外设已经配置好[引脚/外设/时钟]。 请给我一个实现思路，从软件架构的角度来分解任务，先分析需要哪些模块，再给代码。模板二：代码生成。
请用[HAL/标准库]写一段[具体功能]的代码，运行在[芯片型号]上。 前提条件：[关键配置，如引脚编号、时钟频率、外设模式]。 要求：[必须满足的约束，如不修改某函数、不使用某种外设]。模板三：报错分析。
我使用[IDE]编译[芯片型号]的工程，编译报错如下： [粘贴完整报错]。 请分析可能的原因，并按可能性从高到低排列。请先帮我检查是否存在[常见配置问题]。模板四：代码走查。
请帮我Review以下代码，找出潜在的bug和隐患。 注意检查：[越界、死锁、中断安全、位运算优先级]。 同时也指出代码风格上的问题。这几个模板的核心思路是一致的：给AI足够多的上下文约束，它才能输出足够精准的答案。你把引脚号都写在提示词里，它怎么可能生成接错引脚的代码？你明确要求“不要使用定时器”，它就老老实实写延时。AI编程的上限，很大程度取决于你提问质量的上限。
我还想专门提醒一点：AI生成代码，一定要逐行读懂再编译。我不只一次看到有人复制AI给的标准库代码，跑到HAL库的工程里编译，报错十来个，然后跑回来问AI怎么回事。不是AI不行，是它按你的提示词“应该用HAL库”，但训练数据里那个函数的标准库写法已经刻进它的惯性里了。解决的办法很简单：AI给完代码，你花三十秒扫一遍函数名、参数类型，跟当前工程的风格对一下，再往工程里放。养成这个习惯，能省去大量低级报错。
最后再撒个私货。我实际体验下来，如果一次只能选一个功能让AI辅助，那我会选串口调试。让AI生成一套完整的串口重定向代码，printf一打通，后续所有调试都豁然开朗。你看到的每个变量的值都能从串口助手里打出来，跟AI对话的时候，把串口日志粘贴过去，它定位问题的速度能比盲猜快几倍。这是让我真正觉得“AI编程靠谱”的瞬间。你跑完跑马灯，不妨试试这个方向。
