USB JTAG/serial debug unit：端口消失或编号变了
ESP32-C3 常见问题 · 排查从第 L1 层开始
日志里常见的字样
USB JTAG/serial debug unit端口COM 消失不见变了换了could not open port FileNotFound找不到这条报错说明什么
原生 USB 在复位、进入下载模式时会断开再重新连接，Windows 可能给它分配新的 COM 编号。
先做这一步
复位后等两三秒，在端口列表里重新选择（名称通常是「USB JTAG/serial debug unit」或「USB 串行设备」）；连接不稳时换一根短的数据线，直接插电脑主板的 USB 口。
按顺序排查，别跳步
- L0供电：核对供电与指示灯
- L1连接：确认 USB、驱动与端口
换用确认可传输数据的 USB 线，检查系统设备列表。 - L2烧录：检查模式、工具与配置
- L3最小程序：建立独立运行基线
- L4串口：确认运行日志
- L5外设：逐个验证接线和通信
ESP32-C3 SuperMini 的注意事项
- GPIO 不耐受 5V。
- 板载蓝色 LED 在 GPIO8，低电平点亮；BOOT 键接 GPIO9。GPIO2、8、9 影响启动，外设不要在上电时把它们拉低。
- 没有 USB 转串口芯片，串口走芯片自带的 USB：Arduino IDE 必须把「USB CDC On Boot」设为 Enabled，否则 Serial 什么都打印不出来。
- 程序复位或进入下载模式时，电脑上的 COM 口会消失再出现，有时编号会变，需要重新选择端口。
- 一些库默认 I²C 用 GPIO8/9，但它们是 LED 和 BOOT 键；这里的 I²C 模板改用 GPIO4（SDA）/ GPIO5（SCL）。
- GPIO0–4 是 ADC1，GPIO5 是 ADC2（Wi-Fi 打开时 ADC2 不能用）。
- 「SuperMini Plus」版本的 GPIO8 是 WS2812 彩灯，不是普通 LED。
相关问题
板伴 Boardly · 给硬件初学者的免费排错工具。内容依据公开资料整理，尚未逐条经过实物验证，请以实际测量为准。