企业官网建设流程全解析

调试STM32的时候，最让人血压升高的瞬间之一，就是你在Keil里写好了代码，信心满满地点了一下Download，结果弹出来一个冷冰冰的提示：No ST-LINK detected!——检测不到ST-LINK。遇到这个报错，很多人第一反应是检查线有没有插好，但有时候线明明插得好好的，依然报错，这就会让人开始怀疑人生。

这个问题几乎每个用过STM32的开发者都会碰到，尤其是刚入门那会儿，一个"No ST-LINK detected"能卡你一整个下午。其实这个报错并没有它看上去那么吓人，绝大多数情况下都是小问题，排查思路理顺了，几分钟就能解决。这篇内容我就结合这些年实际调板子踩过的坑，把这个报错从硬件到软件、从常规到极端情况都梳理一遍，新手可以直接按顺序排查，老手也可以看看有没有漏掉的细节。

1. 报错出现的典型场景：从“点一下Download”到“心态崩了”

1.1 “No ST-LINK detected”到底是个什么错误

先说结论：这个报错字面上的意思就是，Keil（或者其他烧录工具）在电脑的USB口上没有找到ST-LINK调试器，或者找到了ST-LINK但无法和它正常通信。ST-LINK是ST官方推出的调试器，负责把Keil里的固件通过SWD或者JTAG接口烧录到STM32芯片里，同时也能做在线调试、设置断点、查看寄存器。Keil每一次下载程序之前，都会先枚举USB设备，寻找ST-LINK的驱动节点，找不到就直接弹窗。

这个报错的麻烦之处在于，它只告诉你"没检测到"，但不告诉你"为什么没检测到"。可能是ST-LINK本身坏了，可能是USB线坏了，可能是驱动没装，可能是目标板没供电，可能是SWD引脚被代码复用成了GPIO，甚至可能是芯片开了读保护。排查的关键不是记住一个万能解法，而是理解这条错误链上有哪些环节，然后一个一个排除。

1.2 几种常见报错变体，别被名字唬住

实际开发中，"No ST-LINK detected"只是众多相似报错中的一种，很多人会被不同的英文提示吓到，其实它们的根源往往相同：

遇到任何一条都不要慌，先确认一件事：电脑到底有没有识别到ST-LINK硬件。打开设备管理器，插拔一下ST-LINK的USB口，看有没有设备状态变化。如果插上去一点反应都没有，那就是USB层面的问题；如果有反应但连不上芯片，那就是后面几节要讲的SWD和目标板问题。把这两个方向分开，排查逻辑就清晰多了。

2. 先查硬件：接线、供电、复位，八成问题出在这

2.1 SWD四线连接的正确姿势

很多第一次用ST-LINK的同学，会拿着ST-LINK/V2上那排排针发懵：这么多脚，到底要接哪几根？其实烧录STM32只需要四根线：SWDIO、SWCLK、GND、3.3V。对应到STM32芯片上，SWDIO是PA13，SWCLK是PA14，GND接GND，3.3V接3.3V电源。个别情况下还需要接NRST复位线，这个后面细说。

这四根线的对应关系一定要检查清楚，尤其是买了那种散装的ST-LINK/V2，排针上的丝印有时候并不标准。我就见过一个同学把SWDIO接到了SWCLK上，还反复怀疑是板子坏了。另外，GND必须共地，这是SWD通信的前提。ST-LINK的GND和目标板的GND如果不连，信号根本没有参考电平，通信必然失败。

注意：ST-LINK/V2上面的3.3V引脚虽然可以给目标板供电，但它的输出电流非常有限，大概只有几十到一百毫安。如果你在调试一块带OLED屏幕、电机驱动或者ESP8266模块的板子，强烈建议目标板用独立电源，只把GND和SWD两根信号线连到ST-LINK上。

2.2 目标板供电与复位电路的影响

紧接上面说的问题，目标板供电不稳定是隐藏很深的一个坑。有时候你看着ST-LINK灯亮着，Keil也能识别到设备，但就是连不上芯片，报"Can not connect to target"。这时候用万用表量一下目标板的3.3V引脚，如果电压低于3.0V，或者上电瞬间电压有严重跌落，那SWD通信就可能失败。

不少USB供电的板子会有这个问题：电脑USB口本身输出能力就参差不齐，再加上板载LDO的压降，带载之后电压就掉得厉害。遇到这种情况，换个独立5V适配器供电，或者换一个供电能力强的USB口，很可能就好了。

复位电路也值得看一眼。有些开发板的复位电容选得偏大，导致上电后芯片复位时间过长，ST-LINK在连接的时候芯片还没完成初始化。这个问题的典型表现是：多试几次偶尔能连上，但概率很低。解决办法是按住复位键再点Download，或者把复位电容换成100nF左右的小容量电容。

2.3 杜邦线、面包板和干扰的坑

面包板和杜邦线是新手期的标配，也是连接问题的高发区。面包板内部的金属簧片用久了会氧化，插拔次数多了会松，有时候看起来线插进去了，实际上内部根本没接触上。我的建议是：调试阶段尽量用排线或者直接焊线，面包板只适合做非常简单的验证，碰到连接问题时第一个怀疑对象就应该是接触不良。

SWD的两根信号线SWCLK和SWDIO比较容易受干扰。如果目标板旁边有电机、继电器、舵机这类大电流设备在运行，SWD通信很容易被拉垮。调试时最好把大功率负载先断电，烧录完再跑程序。如果线比较长（超过20厘米），可以把ST-LINK的SWD频率调低，比如从默认的4MHz降到1MHz甚至100kHz，通信稳定性会明显改善。

另一个经常被忽略的是USB线本身。很多ST-LINK/V2用的是Mini USB口，手边随便抓一根线可能只有充电功能，没有数据传输能力。插上之后ST-LINK指示灯亮了，但电脑就是识别不到设备。这种线材问题排查起来特别费时间，建议直接准备几根确定能传数据的线备用。

3. 软件与驱动：Keil设置、驱动安装、固件升级

3.1 ST-LINK USB驱动排查

硬件层面排除完之后，接下来看软件。插上ST-LINK，打开设备管理器，展开"通用串行总线设备"或者"通用串行总线控制器"，正常情况下应该能看到一个带"ST-LINK"字样的设备条目。如果在"其他设备"里看到带黄色感叹号的未知设备，说明驱动没装好。

ST-LINK的驱动安装有两个途径：一是装ST官方工具链时顺带安装，比如STM32CubeProgrammer或者STM32 ST-LINK Utility；二是单独下载ST-LINK驱动包手动装。很多人在Keil里折腾半天，最后发现装一个STM32CubeProgrammer就什么都解决了，因为CubeProgrammer安装过程中会静默装好ST-LINK的所有驱动组件。装上之后Keil的"Utilities"里也能正确识别ST-LINK了，这种情况我见过不止一次。

实操心得：如果你发现自己装了Keil但插上ST-LINK后设备管理器毫无反应，先别急着怀疑ST-LINK坏了。花两分钟装一个STM32CubeProgrammer，装上之后再回设备管理器看，大概率能解决驱动问题。这个顺序比单独去找驱动省事得多。

3.2 Keil MDK的Debug设置细节

驱动没问题，但Keil还是报"No ST-LINK detected"的话，要检查Keil的调试器设置。菜单栏进入Options for Target，切到Debug选项卡，右侧的下拉框必须选成"ST-Link Debugger"，然后点旁边的Settings按钮。这里有几个关键信息要看：

• 如果Settings里能看到一个ST-LINK设备列表，说明Keil已经识别到ST-LINK了，问题出在后续连接。
• 如果设备列表是空的，说明Keil没识别到ST-LINK，优先回头查驱动。
• Settings里还有一个SW Device区域，如果能看到类似"STM32F103CB"这样的芯片IDCODE，说明ST-LINK和芯片通信正常，那Keil还报错就可能是其他环节的问题。

另外别忘了Utilities选项卡，烧录操作也跟这里的设置有关。一般IDE初始化时会自动配置好，但如果你手动改过Flash Download的相关选项，可能把烧录算法弄丢了，导致点击Download时报出莫名其妙的错误。到Utilities选项卡里点Settings，确认Programming Algorithm里有对应Flash的烧录算法（比如STM32F10x Flash），没有就点Add补上。

3.3 ST-LINK固件老版本与新版本的区别

ST-LINK本身是带固件的，出厂时固件版本可能比较老。随着Keil、IAR这些工具链的更新，老固件的ST-LINK有可能会出现兼容性问题，比如Keil新版本要求ST-LINK固件不低于某个版本，否则通信不稳定或者干脆不识别。

检查固件版本的方法有两种：一种是在STM32CubeProgrammer的Firmware Upgrade界面看当前固件版本，另一种是在Keil的Settings弹窗里看。如果固件版本确实很老，点击升级即可。但这里有个先后顺序要注意：升级固件的前提是电脑能正常识别到ST-LINK，如果设备管理器里都看不到ST-LINK，那就别想着升级固件了，先把驱动问题解决再说。

固件升级本身有一定风险，升级过程中绝对不能拔USB线。另外，早期山寨版ST-LINK/V2用的是第三方芯片方案，可能不支持固件升级或者升级后会变砖。如果你手里是这种设备，升级固件前要掂量一下。

4. 芯片端的问题：SWD引脚复用、读写保护、低功耗锁死

4.1 禁用JTAG后SWD为什么还能用？关键在引脚配置

硬件和驱动都没问题、但就是连不上芯片的时候，问题往往就出在芯片本身的状态上。最常见的一种是：代码里把SWD引脚给复用掉了。

STM32的PA13和PA14默认是SWDIO和SWCLK，但它们同时也是普通GPIO，可以被配置成其他复用功能。比如有的工程初始化时会调用GPIO_PinRemapConfig(GPIO_Remap_SWJ_Disable, ENABLE)，这句代码会把整个SWJ调试接口全部关闭，包括JTAG和SWD。代码一旦跑起来，PA13和PA14就变成了普通GPIO，ST-LINK自然就连接不上了。

不过这里有一个关键细节：芯片在复位状态下，SWD功能是默认开启的。也就是说，STM32刚上电那几十毫秒里，SWD引脚是正常的调试接口。只要利用好这个窗口期，就能把固件擦掉或者重新烧录。具体操作是：按住目标板的复位键不放，在Keil里点击Download，看到进度条走动的那一瞬间松开复位键。这个技巧能救回绝大多数"引脚被复用"的板子。

4.2 读保护/写保护导致连接失败的处理

还有一种情况更隐蔽——芯片开了读保护。STM32的Option Bytes里有RDP（Read Protection）选项，分Level 0、Level 1、Level 2三档。Level 0是默认无保护，一切正常；Level 1是中等保护，芯片不能通过SWD读Flash，也不能调试，会直接导致连接失败或者只能连上但读不了内核；Level 2是最强保护，开了之后芯片就永久锁死了，没有任何调试接口能救回来。

自己调试代码的过程中不会平白无故开读保护，但架不住有人把别人量产的板子拿过来用，或者用STM32CubeProgrammer不小心改了Option Bytes。如果你的板子之前烧过程序、也正常跑着，突然有一天就"No ST-LINK detected"了，可以怀疑一下读保护。用STM32CubeProgrammer连接时，选择"Connect under reset"模式，有时候能强行连上，然后把RDP改回Level 0。注意，解除读保护会触发全片擦除，芯片里的程序就没了。

注意：RDP Level 2一旦开启，等于芯片的调试口永久报废，只能通过系统存储器引导或者别的接口重新编程，开发阶段千万不要去碰这个选项。

4.3 低功耗模式与时钟跑飞时的救援思路

芯片进入低功耗模式也是一个常见原因。如果你写的代码里调用了WFI或者进入了STOP、STANDBY模式，芯片的调试接口会停止响应。这时候跟前面引脚复用一样的道理，利用复位窗口期可以重新建立连接。按住复位键再点连接，几乎每次都能救回来。

时钟配置错误同样会让芯片无法工作。比如板子上用的是内部RC振荡器（HSI），但代码里配的是外部晶振（HSE），又没有做时钟失效检测，导致芯片上电后一直等晶振起振而死机。这种问题不是"死"在硬件上，但对外表现也是ST-LINK连不上。救法依然是用"Connect under reset"或者按住复位键再下载。

顺便说一句，如果你用的芯片在跳线帽或者BOOT引脚上能进入系统存储器引导模式（ISP模式），那也是一个备选方案。通过串口ISP可以把Flash擦掉，让芯片恢复默认状态，然后用SWD重新连接。不过这个方案需要额外的USB转串口工具，没有的话还是优先用复位窗口大法。

5. 救场工具与进阶排查技巧

5.1 STM32CubeProgrammer连接与全片擦除

如果说Keil是日常烧录的首选，那STM32CubeProgrammer就是关键时刻的救场工具。这个工具比Keil更贴近硬件层，能做的操作也更多，包括连接、擦除、烧录、设置Option Bytes、读取芯片信息等等。遇到Keil死活连不上的情况，先用CubeProgrammer试一把，往往能定位问题。

打开STM32CubeProgrammer之后，右上角选择ST-LINK，接口选SWD，速度先设低一些（比如1MHz）。然后在连接之前，注意看界面左下角有没有"Connect under reset"选项，建议勾上。再配合手动按住目标板复位键，点Connect，盯着日志窗口。如果看到"Target connection ... OK"之类的提示，说明芯片已经有响应了，接下来可以用"Full chip erase"把Flash擦干净，芯片就恢复正常了。

我之前遇到过一块板子，Keil报"No ST-LINK detected"，但STM32CubeProgrammer能连上，原因是Keil的配置被某个工程文件污染了，重新建了个工程就好了。如果你也遇到这种"Keil不行，CubeProgrammer行"的情况，别在Keil里死磕，直接重建工程或者换台电脑试一下，效率高得多。

5.2 使用ST-LINK Utility应急处理的完整流程

老玩家可能更熟悉STM32 ST-LINK Utility这个工具，虽然ST官方已经停止更新了，但许多工程师手里还留着它应急。它的操作逻辑和CubeProgrammer类似：Target -> Connect，连接时也可以设置SWD速度。Utility对老型号的STM32F1支持得特别好，连接速度快，界面也简洁。

应急处理的流程我建议这样：先插上ST-LINK，打开Utility，如果Target菜单里能正常Connect，说明ST-LINK本身没问题，问题就在Keil配置那边。如果Utility也连不上，再看Target -> Settings里的连接速度，把速度调到最低再试一次。还是不行的话，按住目标板复位键再Connect，多半能成。Utility里也有Full Chip Erase选项，擦完之后再去Keil里正常烧录。

5.3 终极手段：断电、短复位、按住Reset再下载

有些板子状态特别顽固，普通方法都试了还是不行。这时候我一般会按下面的顺序做一组"终极操作"，能救回大部分看似已死的板子：

• 完全断电：把目标板的电源和ST-LINK都拔掉，等5到10秒，让所有电容放完电，再重新上电。很多瞬时故障靠这一招就能消除。
• 换USB口：尽量用电脑后置的USB口，不要用前置USB口或者USB Hub。USB Hub供电不稳，通信质量差，对ST-LINK这种对时序敏感的设备尤其不友好。
• 按住复位键点Download：这个技巧我前面反复提到，因为它确实管用。具体操作是左手按住目标板复位键不放，右手点Keil的Download，看到进度条或者下载日志开始滚动之后马上松手。整个过程要果断，松手太早芯片会处于复位状态连不上，太晚下载会失败，多试几次就能找到节奏。
• 必要时把NRST线也接上：有的ST-LINK有NRST引脚，把它接到目标板复位脚上，配合"Connect under reset"模式，能大幅提高连接成功率。

这组操作再不行，那就要怀疑硬件损坏了。换个ST-LINK、换块板子交叉测试，能很快定位是调试器坏还是目标板坏。我自己就碰到过ST-LINK/V2的SWDIO引脚虚焊的情况，板子没问题，是调试器坏了，换一个立刻就好了。

6. 常见问题速查表与我的避坑清单

6.1 从报错到解决的一分钟对照表

根据多年踩坑经验，我把最常见的情况整理成一个对照表，遇到问题直接查表：

6.2 少走弯路的几条经验

最后分享几条我从一次次"No ST-LINK detected"里总结出来的经验，不一定写在文档里，但实践中非常有用。

第一，新板子拿到手第一件事不是写代码，而是用STM32CubeProgrammer试一下能不能连上芯片。如果能连上，说明板子的SWD链路线路是通的，后面出了问题至少能排除硬件基础。这一步只要两分钟，却能为后续排查省下大把时间。

第二，开发阶段尽量不要在KEIL里面开读保护，更不要手贱去点Option Bytes里那些看不懂的选项。Level 2级别的读保护一旦开了就是永久性的，任何工具都救不回来。

第三，手边常备一根确定能传数据的Mini USB线或者Type-C线（看你ST-LINK的接口），千万别用那种只能充电的线。这个问题排查起来极其费劲，明明看着插上了、灯也亮了，但就是识别不到设备，结果换根线就好了——我已经用这个思路帮三个人解决了同样的困扰。

第四，学会使用STM32CubeProgrammer的"Connect under reset"功能。这是我在实际调试中救回板子最多的一个按钮，不管是引脚复用、读保护还是低功耗锁死，配合手动按复位键几乎都能连上。

最后再多说一句，如果你用的是Keil 5，记得在Pack Installer里装好对应型号的芯片包（比如STM32F1系列的DFP），不然新建工程时选不到芯片，或者打开旧工程时提示缺少Device，这虽然不是"No ST-LINK detected"的直接原因，但两个问题经常连在一起出现，一起排查能省不少事。