VS Code串口监视器无输出但Putty正常的技术求助

问题背景 #

ESP32-C3设备代码运行正常（LED状态符合预期），Putty能正常读取串口输出，但VS Code的PlatformIO串口监视器无法显示内容。已确认端口正确（监视器占用COM30时Putty无法连接），VS Code更新后出现该问题，尝试过调整DTR/RTS、重置设备、重启监视器均无效。

设备代码片段：

void setup() {
    Serial.begin(115200);

    delay(2000);

    Serial.println("setup()");

    FastLED.addLeds <WS2812, DATA_PIN, GRB>(leds, NUM_LEDS);
    FastLED.setBrightness(20);
    leds[0] = CRGB::Grey;
    FastLED.show();
    delay(2000);

    leds[0] = CRGB::Green;
    FastLED.show();

    Serial.println("Starting NimBLE work!");

    delay(2000);
}

当前platformio.ini配置：

[env:esp32-c3-devkitc-02]
platform = espressif32
board = esp32-c3-devkitc-02
framework = arduino
monitor_speed = 115200
monitor_filters = direct
monitor_dtr = 1
monitor_rts = 0
monitor_eol = LF
monitor_echo = yes
build_unflags = -std=gnu++11
build_flags = -std=gnu++17
    -DARDUINO_USB_CDC_ON_BOOT=1
    -DARDUINO_USB_MODE=1
lib_deps = 
    h2zero/NimBLE-Arduino@^2.3.0
    fastled/FastLED@^3.9.16

解决方案尝试 #

1. 调整DTR/RTS信号配置 #

ESP32-C3的USB CDC串口对DTR/RTS信号敏感，尝试将两个参数都设为0，避免触发不必要的设备重启：

monitor_dtr = 0
monitor_rts = 0

保存配置后重新上传代码，再打开串口监视器测试。

2. 关闭串口回显功能 #

monitor_echo = yes会让监视器回显发送的字符，可能干扰输出显示，尝试修改为关闭：

monitor_echo = no

3. 更换串口过滤器 #

当前direct过滤器可能无法兼容部分串口数据格式，尝试改用默认过滤器或移除该配置：

monitor_filters = default

或者直接删除monitor_filters行，使用PlatformIO默认配置。

4. 检查插件与平台版本兼容性 #

VS Code更新后可能和PlatformIO插件存在适配问题，尝试：

• 打开VS Code扩展面板，找到PlatformIO IDE插件，点击「重新安装」
• 降级espressif32平台到之前能正常工作的版本，比如指定版本号：

  platform = espressif32@5.3.0
  

5. 明确指定USB CDC串口 #

ESP32-C3启用USB CDC后，可能存在虚拟串口和硬件串口的混淆，尝试在代码中明确使用USB CDC串口：

void setup() {
    // 替换Serial为SerialUSB，对应USB CDC虚拟串口
    SerialUSB.begin(115200);
    while (!SerialUSB) delay(10); // 等待串口就绪

    delay(2000);
    SerialUSB.println("setup()");
    // 其余代码中所有Serial调用替换为SerialUSB
}

保持platformio.ini中-DARDUINO_USB_CDC_ON_BOOT=1和-DARDUINO_USB_MODE=1的配置不变。

6. 重置VS Code本地配置 #

若VS Code的本地配置出现异常，尝试：

• 关闭VS Code，备份项目目录下.vscode/settings.json后删除该文件
• 重新打开项目，重新配置串口监视器

内容的提问来源于stack exchange，提问作者Rob190