检查串口设备
在 macOS 上使用 VS Code + ESP-IDF 时，要找出你的板子对应的串口设备（COM 口的概念在 Windows，这里实际是 /dev/tty.* 或 /dev/cu.* ），步骤如下：
1. 插上 ESP32/ESP8266 开发板
- 用 USB 线接入你的 Mac。
- 确认 USB 线支持数据传输（有些线只能充电）。
2. 查看串口设备
在终端执行：
ls /dev/tty.*
或者更推荐：
ls /dev/cu.*
这会列出所有串口设备。常见的 ESP 开发板芯片会被识别为：
- CP2102 芯片：
/dev/cu.SLAB_USBtoUART - CH340 芯片：
/dev/cu.wchusbserial* - FTDI 芯片：
/dev/cu.usbserial-* - 乐鑫官方 CDC 驱动：
/dev/cu.usbmodem*
举个例子：
❯ ls /dev/tty.*
/dev/tty.Bluetooth-Incoming-Port /dev/tty.usbmodem1234561
/dev/tty.debug-console
❯ ls /dev/cu.*
/dev/cu.Bluetooth-Incoming-Port /dev/cu.usbmodem1234561
/dev/cu.debug-console
其中
/dev/cu.usbmodem1234561
这就是你的 ESP32 板子所对应的串口设备。
3. 在 VS Code 中选择串口
如果你安装了 ESP-IDF VS Code Extension，有两种方式来设置串口：
方法 A：在 VS Code 配置里设置
- 按
Command + Shift + P呼出命令面板 - 输入
ESP-IDF: Device Configuration - 在
Serial Port一栏里选择检测到的/dev/cu.…设备
方法 B：在 idf.py 命令中指定
如果你喜欢用终端或 VS Code Terminal：
idf.py -p /dev/cu.usbmodem1234561 flash monitor
这样直接指定串口就能烧录并查看日志了。
4. 如果没看到设备
- 可能需要安装 USB 驱动：
- CP210x → Silicon Labs 官方驱动
- CH34x → WCH 官方驱动
- 可以插拔 USB 再执行
ls /dev/cu.*，观察新出现的设备名。
✅ 小技巧：用 screen 或 miniterm.py 测试串口
screen /dev/cu.SLAB_USBtoUART 115200
退出 screen：按 Ctrl+A 然后 K。