ST-LINK虚拟串口驱动V1.5.0安装与故障排查全指南

搞STM32开发的，几乎没人能绕开那个黄色感叹号。板子插上USB，电脑“叮咚”一声，然后设备管理器里冒出一个带问号的“STMicroelectronics Virtual COM Port”，又或者干脆显示“未知设备”——这时候你就知道，该装STSW-STM32102这个驱动了。

V1.5.0是ST官方这套虚拟串口驱动里用得比较久的一个版本，覆盖面很广。凡是带ST-LINK的Nucleo板、Discovery板，或者独立ST-LINK V2/V3调试器，虚拟串口功能全靠它撑起来。有些人会问，我装了Keil或者STM32CubeIDE，为什么还要单独装这个驱动？很简单，IDE自带的是调试下载功能那一套USB协议栈，虚拟串口是USB里的另一个“设备”，Windows默认不认识，必须得给它专门装一张“身份证”。这篇就把这事的来龙去脉、安装细节、踩坑记录一次性讲透。

1. 虚拟COM端口到底是什么，为什么STM32开发离不开它

1.1 ST-LINK里的“隐藏串口”

先理清一个概念。ST-LINK调试器插到电脑上，走的物理接口是USB，但它在Windows里会“分裂”成好几个设备，最常用的是两个：一个是“STLink dongle”或者“ST-LINK Debug”这种调试接口，另一个就是“Virtual COM Port”——虚拟串口。

这个虚拟串口本质上就是ST-LINK板载的USB转串口电路加固件模拟出来的。MCU端接到ST-LINK的TX/RX引脚上，你写代码的时候把printf重定向到UART，数据通过ST-LINK的虚拟串口送到电脑，电脑上的串口助手就能收到。反过来，电脑串口助手发的数据也会通过这个虚拟口进到MCU的串口接收引脚。

V1.5.0这个版本号平时很少有人提，ST官方驱动包的全称就叫“STSW-STM32102”，版本迭代从V1.3.0、V1.4.0一路走到V1.5.0。V1.5.0之所以普及度高，是因为它支持了Win7到Win10全线的桌面系统，在Win7 X64和Win10 1909这种组合上表现都稳定，不像早期版本在Win8.1之后偶尔会出兼容性弹窗。

1.2 没有驱动会怎样

不装驱动最直观的后果就是设备管理器里出现“USB 串行设备”或者带黄色感叹号的“STMicroelectronics Virtual COM Port”。这时候你打开任意串口助手，下拉框里根本找不到COM号，程序里open /dev/ttyUSB0或者COM3自然也是失败的。

还有个容易忽略的场景是STM32的ISP下载。很多STM32芯片出厂bootloader支持从USART1下载程序，但前提是你得有一个能用的COM口。没有虚拟串口驱动，哪怕你板子上的BOOT0已经拉高，上位机软件也只会报“Connection error”或者直接找不到端口。

另外，现在STM32CubeProgrammer也依赖虚拟串口做Bootloader交互，连新发布的很多IoT评估板，出厂固件默认都是通过VCP口打印日志或者进入AT指令模式。驱动不装好，板子等于半砖状态。所以别小看这个“小驱动”，它是调试链路里最底层的一环。

2. 安装前的准备工作与系统兼容性判断

2.1 确认你的调试器型号和接口类型

STSW-STM32102这个驱动V1.5.0主要针对ST-LINK系列，但要注意老款的ST-LINK（就是那种不带V2标记的蓝白小棍）和带V2/V3的调试器，驱动签名链不一样。V1.5.0对ST-LINK V2、板载ST-LINK（Nucleo、Discovery板上的）以及ST-LINK V3都有覆盖，理论上都能用，实际装的时候你要先确认你插上USB后设备管理器里识别出来的是什么硬件ID。

怎么看？USB设备右键-属性-详细信息-硬件ID，能看到VID_0483和PID_3748或PID_374B之类的值：

• VID_0483是ST的厂商ID；
• PID_3748对应ST-LINK/V2的调试接口；
• PID_374B对应的是ST-LINK/V2板载在Nucleo上的调试口。
• ST-LINK/V3的PID不一样，一般是PID_3754或PID_375F。

如果硬件ID里的VID不是0483，而是别的厂商ID，比如CH340的VID_1A86或者CP2102的VID_10C4，那说明你插的根本不是ST-LINK的虚拟串口，而是板子上另外焊了一个独立USB转串口芯片，这时候装STSW-STM32102一辈子也解决不了问题。这一点必须先排查清楚，别白忙活。

2.2 32位和64位系统的驱动差异

V1.5.0驱动包是一个压缩包，里面有多个文件夹，区分x86和x64版本，还区分了不同Windows系统的INF文件。安装之前先确认你的系统位数，Win10下右键“此电脑”-属性，看“系统类型”。现在99%都是64位，但老工程师手里偶尔还有32位的Win7测试机，这时候如果装错了x64驱动，系统会给“这个INF文件没有包含数字签名”或者直接提示“找不到驱动程序”。

另外有个坑：V1.5.0发布时针对的老系统是Win7/8/8.1，但装在Win10和Win11上也没问题，系统会自动识别为“USB 串行设备”的兼容驱动（usbser.sys）。不过Win11 22H2之后微软对第三方驱动签名更严格，如果你遇到“Windows无法验证此设备所需驱动程序的数字签名”，先别慌，这不一定是你装的驱动有问题，更常见的是你板子插上后Windows更新自动装了个不匹配的驱动，这时需要手动指定驱动位置。

2.3 IDE里的另外一种“驱动”别搞混

新手最容易混淆的是：Keil MDK装完，或者STM32CubeIDE装完，是不是就不用装虚拟串口驱动了？答案是否定的。Keil的ULINK驱动、ST-LINK的调试驱动，和VCP是两码事。STM32CubeIDE安装过程中会附带安装ST-LINK的USB驱动，也就是调试接口能被Keil识别，但虚拟串口的驱动经常不被自动安装，或者装的是ST-Link WinUSB驱动而不是真正的VCP驱动。

CubeProgrammer也是同一个道理，它认识ST-LINK的调试口，但你点开“USART”或者“UART”连接方式时，它找的还是COM口。这个COM口如果没有驱动，CubeProgrammer的日志里会一直提示“No STM32 target found”，搞了半天发现根本没出现COM号，实际就是驱动缺失。

还有一类是Windows更新有时会默认把ST-LINK虚拟串口识别成“Ports (COM & LPT)”下的“STMicroelectronics Virtual COM Port (COM5)”，但有时又识别成“通用串行总线设备”下的“USB 串行设备”，这两种情况分别对应INF安装成功和没有安装成功的状态。后者虽然串口助手也能看到COM号，但工作不正常，比如打不开或者打开就报错。

3. 标准安装流程与关键细节操作

3.1 拿到驱动包，正确解压

STSW-STM32102 V1.5.0的压缩包解压后，你会看到大致这样的结构：

• VCP_V1.5.0_Setup_W7_x64_64bits.exe之类的安装程序，或者
• 纯INF文件加驱动的文件夹。

V1.5.0其实分了两种封装：一种是带exe的自动安装版，另一种是手动INF版。这里强烈建议优先用exe自动安装版。为啥？因为手动INF版要求你关掉驱动强制签名校验，在Win10 X64上反而容易出岔子。自动安装版的本质其实是调用DPInst.exe，把INF和sys文件装进系统驱动库里，而且它会自动处理Windows的“PnP Util”刷新动作，装完基本不用重启。

解压路径建议放在纯英文目录下，比如D:\drivers\ST_VCP。用中文路径虽然一般没事，但我在一个Win7的机器上见过因为路径里有中文导致DPInst安装中途报错“0x00000002”，换到纯英文路径就好了。这种玄学问题能避就避。

3.2 自动安装步骤（最省心）

1. 先插上ST-LINK或者Nucleo板，让Windows识别到未知设备。此时可以不用管设备管理器里的报错。
2. 如果以前装过旧版驱动，建议先在“设置-应用”里看看有没有“STMicroelectronics Virtual COM Port”相关的软件条目，有的话先卸载旧版，再把USB拔掉重插。
3. 双击解压后的Setup_VCP或者VCP_V1.5.0_Setup_W7_x64_64bits.exe。如果弹出UAC用户账户控制，点“是”。
4. 安装过程很快，几秒钟就完，不用重启。看到“Installation completed successfully”或者驱动安装向导提示设备可以使用，就可以把USB拔掉再插一次（重新枚举），让驱动对新硬件生效。
5. 打开设备管理器，展开“端口 (COM和LPT)”，应该能看到“STMicroelectronics Virtual COM Port (COMx)”，x一般是3到几十之间的一个数字。

如果在第4步安装过程中弹出“Windows安全”对话框，提示“您要安装此设备软件吗”，记得勾选“始终信任来自STMicroelectronics的软件”，然后点“安装”。不勾选的话，安装会中断，设备还是黄叹号。

还有一个细节：插上板子后，Windows如果弹出“设备安装设置”的提示，选择“自动获取驱动程序”还是“手动选择”都不要紧，但如果你用的是公司域账号，系统可能锁定了驱动安装权限，会提示“此设备已被策略禁止”，这种情况需要找管理员放行。

3.3 手动指定INF的安装方法（老系统备用）

有些精简版系统或者Windows LTSC版本，自动安装exe时可能因为缺少.NET组件，或者DPInst版本过旧，装到一半没反应。这时候可以用传统的手动指定INF方式，步骤是：

1. 设备管理器里找到带黄色感叹号的“STMicroelectronics Virtual COM Port”或者“未知设备”。
2. 右键-“更新驱动程序”-“浏览我的电脑以查找驱动程序”。
3. 选择“让我从计算机上的可用驱动程序列表中选取”-“从磁盘安装”。
4. 浏览到解压目录下对应你系统位数的文件夹，比如V1.5.0\win10_x64或者V1.5.0\win7_x64，选中stmcdc.inf。
5. 确认后系统会提示“Windows已成功更新你的驱动程序”。

注意，Win8和Win10往后的系统要求驱动必须签名，V1.5.0官方的INF和sys文件都是WHQL签过名的，所以正常情况不会弹签名警告。如果你看到“Windows无法验证此设备所需驱动程序的数字签名”，大概率是驱动文件不全或者下载过程中损坏了。重新解压，然后从干净的源重新安装。

还有一个容易踩的坑：如果此时设备管理器里的未知设备显示的是“USB Composite Device”而不是“STMicroelectronics Virtual COM Port”，说明USB枚举就失败了，不完全是驱动问题。先检查USB线是不是只有供电没有数据线的那根“充电线”。这类线材在STM32开发板上极其常见，插上之后板子电源灯亮，但电脑毫无反应。调试时先换个手机数据线试，别急着折腾驱动。

4. 常见问题与排查技巧实录

4.1 装了驱动但端口不出现或一闪而过

我遇到过不少次，驱动装好后设备管理器里能看到“STMicroelectronics Virtual COM Port”，但几秒钟后自动消失，或者我这里明明显示正常，但串口助手选不到。这种问题多半不是驱动安装失败，而是USB枚举不稳定或电源问题。

先说电源。STM32F4的Nucleo板、F103的Blue Pill外接ST-LINK下载器，如果同时给目标板供电，USB口供电能力不足时会出现枚举到一半断开重连的现象。主板前置USB口尤其明显，后置USB口供电更稳。遇到这种“端口闪现”的情况，先插到主机后置USB口，或者用一个带外部供电的USB HUB。

再一个是ST-LINK固件版本太旧。老ST-LINK V2如果固件停留在V2.J24以前，和新版V1.5.0驱动配合时，有时会出现虚拟串口识别不稳定。解决办法是打开STM32CubeProgrammer，菜单栏“Firmware upgrade”更新ST-LINK的固件到J42以上，再重新插拔。很多人在驱动上折腾半天，其实固件刷一下全好了。

4.2 设备管理器里显示“代码 31”或“代码 28”

代码28是“未安装驱动程序”，说明系统没找到匹配的INF，大概率是安装过程中路径选错，或者INF文件是针对老系统的，手工指定导致不匹配。代码31是“设备工作异常”，这个情况在“USB 串行设备”和“STMicroelectronics Virtual COM Port”两个设备同时共存时出现较多。

原因很简单：电脑里同时装了第三方虚拟串口驱动（比如CH340的ser2pl.sys）和ST的VCP驱动，两者在设备栈上有冲突。解决办法是先把设备管理器里能看到的CH340、CP2102等所有串口设备全部卸载，再把系统卸载里的串口驱动相关软件全部清掉，然后重启，只插ST-LINK重装STSW-STM32102。卸载方式：设备管理器-视图-显示隐藏的设备-端口，展开找到相关COM口右键“卸载设备”，勾选“删除此设备的驱动程序软件”。

代码31还有一种可能是USB选择性挂起。Windows默认的电源管理会在若干秒无数据传输后把USB设备挂起，某些STM32的VCP实现不支持远程唤醒，导致设备直接从系统里消失。解决办法：设备管理器-通用串行总线控制器-USB Root Hub-右键属性-电源管理，取消勾选“允许计算机关闭此设备以节省电源”。注意，有些机器有多个USB Root Hub，一般把插ST-LINK的那个Hub的省电关掉就够了，全关也没事，功耗几乎可以忽略。

4.3 Win10/Win11 数字签名验证失败

这个在新装系统里特别常见。原因分为两种：一种是系统开启“安全启动”并要求内核强制签名，另一种是驱动文件本身没有签名或签名过期。

V1.5.0的官方驱动签名是有效的，但问题往往出在安装方式上。如果你是从设备管理器手动更新驱动，而Windows提示“无法验证驱动程序数字签名”，那99%是安装的驱动文件不对，比如拿32位驱动往64位系统里硬塞。或者，你下载的V1.5.0压缩包是被某下载站重新打包过的，里面混入了不名的第三方驱动。

靠谱的下载路径是ST官网搜索“STSW-STM32102”，选择“Get Software”下载，或者在ST的GitHub仓库（stlink-tool）里下。如果官网下载要注册，可以用ST官方的“STSW-LINK007”或者STM32CubeProgrammer安装包内置的驱动，这两个也是同一个驱动源。

如果确实遇到系统强制签名校验拦截，比如安全企业电脑，可以试着：

1. 将驱动文件放在一个本地目录，比如C:\STDriver。
2. 从设备管理器选择“从磁盘安装”，指向该目录。
3. 若仍然被拒，尝试通过命令行pnputil /add-driver C:\STDriver\stmcdc.inf /install来安装。

pnputil是Windows自带驱动安装工具，它会把驱动加到系统驱动库，然后在设备管理器里手动更新时会自动匹配。这条命令在很多“无法验证数字签名”的场景下能绕过图形界面的限制，因为它是通过驱动库机制安装，签名验证在系统层完成。

4.4 串口助手能打开COM口，但收发数据不对

这个问题和驱动本身的关联度就低了。驱动顺利装上、端口能看到、串口助手不报错，但收不到MCU发来的数据，就要往硬件和代码层面查。

先测回环法：把USB转串口模块的TX与RX直接短接，在串口助手里发数据，如果自己发的能自己收到，说明串口链路基本通。如果收不到，打开或者关闭掉DTR、RTS的勾选试试，很多串口芯片对DTR信号的处理方式不一样，有的在上位机打开串口时把MCU复位了，短接自然失效。

还有波特率问题。ST-LINK的VCP在内部实现上就是一个CDC类ACM设备，Windows用usbser.sys做底层，这个驱动对波特率的支持范围很宽，但它在芯片侧的表现有时候不是硬串口真实波特率，而是虚拟的。也就是说，你MCU侧配了115200，上位机也选了115200，但实际数据是乱的，极有可能是MCU在初始化UART时忘了配置时钟，导致实际波特率偏差超过3%。STM32CubeMX里把UART的时钟源从APB1补算波特率再核对一遍，这个概率比驱动大得多。

4.5 常见问题速查表

5. 驱动的日常维护与版本扩展

5.1 V1.5.0与其他ST驱动共存

有读者问过：我装了V1.5.0之后，是不是以后升级固件要再装一次？其实不用。STSW-STM32102管的是系统的USB串口类驱动，ST-LINK的调试器固件更新用的是另一个名叫STSW-LINK007的软件。两者的关系是：固件更新工具更新的是ST-LINK板上的ST-LINK芯片里的固件，和电脑上的驱动独立。

换句话说，你可以在不重新装驱动的情况下，用STM32CubeProgrammer把ST-LINK的固件从J24刷到J42，刷完以后虚拟串口还是那个虚拟串口，COM口号甚至都不会变。平时我们说的“这个ST-LINK是不是最新的”，指的是固件，不是V1.5.0这个驱动版本。

但有个细节需要记住，V1.5.0的驱动和较新固件组合时，如果在Win7上发现虚拟串口无法打开，提示“Windows无法加载这个设备所需的驱动程序，导致这个设备工作异常。(代码 31)”，这大概率是Win7系统缺失了一个KB3033929补丁，或者说微软在Win7末期更新里的SHA-2签名支持不完整。解决办法是先把系统更新到SP1且装齐推荐补丁，再卸载驱动重装。这个在工业现场老电脑上比较常见，很多人会误判成驱动坏了。

5.2 从ARDUINO到自研PCB：VCP的扩展用法

虚拟串口的好处是隔离了具体的硬件转换芯片，你在Linux下看到/dev/ttyACM0，在Windows下看到COMx，在macOS下看到/dev/cu.usbmodem*，都不用关心底层的USB协议细节。V1.5.0在Windows上是必须装的，但在macOS和Linux上，系统内核通常自带usb-cdc-acm驱动，插上就能出现对应设备文件，不需要装ST的驱动包。

这个特性让它在很多嵌入式项目里成了“默认日志输出口”。比如你在做一个逆变器方案或者双向Buck-Boost数字电源，MCU端通过VCP输出调试日志、电压电流采样值、PID调节参数，上位机用Python的pyserial读取并实时绘图，整套调试环境搭建不到十分钟。在Windows上，只要V1.5.0驱动装好，pyserial就能直接打开COM口，不用额外装东西。

有些高级玩法还会把VCP和ST-LINK的SWD调试接口同时用起来：SWD负责断点、单步、变量读取，VCP负责printf日志。二者互不干扰，这在实时性要求高的电机控制、电源环路调试中极其顺手。我一直建议团队里的新人：拿到新板子第一件事，就是把VCP驱动装好，然后写一个每100ms打印一次系统时钟计数值的程序，验证板子的基本健康度。这一步通过，后再折腾外设就有底了。

5.3 驱动更新时机：不是越新越好

V1.5.0之后ST还发过更高版本的驱动包（比如V1.5.1、V1.6.0等），总的来说新版主要在适配新系统（比如Win11）、修复特定场景下的UAC交互问题。如果你在Win10或者Win7上用得稳，不急着追新版。

一个反面案例：我曾经在一台Win10的机器上把V1.5.0升级到更新的版本，结果Virtual COM Port的COM口号从稳定的COM4跳到COM7，导致上位机软件配置失效。驱动本身没问题，但工程上的教训是：虚拟串口在产线或者实验室里担着自动化脚本的通信任务，没有强需求别随便升级驱动，升级前先导出当前设备管理器配置，并记录好所有软件里填的COM口。

如果真遇到必须升级的场景，稳妥步骤是：“工具-卸载设备-勾选删除驱动-拔线-重启-插新板-装新驱动-验证端口号”。有些人升级完发现串口号变了，非常痛苦，其实可以通过设备管理器-端口-属性-端口设置-高级，把COM端口号手动改成原来的号，很多自动化脚本的“杀招”就在这里——不用担心改端口号会影响驱动稳定性，Windows只是把它当别名。

5.4 和Bootloader刷写相关的两个细节

最后补充两个实操中常被忽略的第二层细节。

第一，STM32的串口ISP下载通常要求USART1复用引脚，而很多板载ST-LINK的虚拟串口，实际上并不连接在USART1上。比如Nucleo板的ST-LINK VCP默认连到目标MCU的USART2（PA2/PA3），也就是说如果你想用这个虚拟串口进Bootloader，需要先把引导程序放在USART2，或者手动跳线。驱动装好只是第一关，真正能不能刷固件还要看板子原理图。这个问题在“stm32 bootloader驱动下载”相关搜索里频繁出现，本质就是对板载串口映射不熟。

第二，在STM32CubeProgrammer里如果你选择“UART”连接方式并选了COM口，它会先拉低/拉高BOOT0相关的信号吗？不会。CubeProgrammer对USB转串口的BOOT0控制，是通过ST-LINK的调试接口间接操作的，纯VCP连接无法控制BOOT0引脚。所以很多人插上VCP想通过串口下载，发现总是连不上目标芯片，这不是驱动的问题，是硬件电路设计里根本没有做BOOT0自动控制逻辑。此时正确的做法是用ST-LINK调试口模式，而不是执着于VCP。

写在后面的实操体会

按我自己摸爬滚打的经验，V1.5.0这个驱动最大的价值是“稳定”。它可能不是功能最多的，但你在一个成熟项目里跑着，没谁会因为驱动带给你惊喜或者惊吓。很多人觉得驱动就是点两下安装的事，其实它牵涉到USB枚举、系统签名策略、端口资源分配、固件兼容、电源管理一整条链路。下次再看到设备管理器里的黄色感叹号，可以先按“换线-换口-看PID-重装驱动”的顺序排一遍，大概率能解决你90%的烦恼。

从前装驱动遇到弹窗报错，我也试过“按住F8进安全模式禁用驱动程序强制签名”这类野路子。后来用多了才发现，90%的情况根本不需要走那一步——选对官方的INF文件，确认系统位数，先卸载再装，比什么歪招都好使。真到了要动用禁用签名那一步的时候，你多半是被系统环境限制住了，那已经不只是驱动的问题了。