串口没有输出：没开「USB CDC On Boot」
ESP32-C3 常见问题 · 排查从第 L4 层开始
日志里常见的字样
ESP32-C3 串口没有输出USB CDC On Boot这条报错说明什么
ESP32-C3 SuperMini 没有 USB 转串口芯片，Serial 要通过芯片自带的 USB 输出；Arduino IDE 默认关闭这个选项，程序在跑，但串口监视器什么都看不到。
先做这一步
Arduino IDE「工具 → USB CDC On Boot」改成 Enabled 后重新上传；PlatformIO 在 build_flags 加 -D ARDUINO_USB_MODE=1 -D ARDUINO_USB_CDC_ON_BOOT=1。上传后按一下 RST，再重新选择端口。
按顺序排查，别跳步
- L0供电：核对供电与指示灯
- L1连接：确认 USB、驱动与端口
- L2烧录：检查模式、工具与配置
- L3最小程序：建立独立运行基线
- L4串口：确认运行日志
核对波特率、TX/RX 与共地；串口能打印不等于所有硬件正常。 - 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 · 给硬件初学者的免费排错工具。内容依据公开资料整理，尚未逐条经过实物验证，请以实际测量为准。