You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在PlatformIO/VSCode中为ESP Wrover 32指定USB上传端口?

解决PlatformIO上传ESP32时指定USB端口的问题

别担心,这个基础问题其实非常普遍,我来帮你一步步搞定它!

首先,你得先确认ESP32连接到电脑后对应的USB端口号:

  • Windows:打开「设备管理器」,找到「端口(COM和LPT)」分类,里面标有USB Serial Port的就是你的ESP32端口(比如COM3)
  • macOS:打开终端,输入命令 ls /dev/tty.*,找类似 /dev/tty.usbserial-xxxx 的条目
  • Linux:打开终端,输入 ls /dev/ttyUSB* 或 ls /dev/ttyACM*,对应的就是ESP32的端口

接下来给你几种指定端口的有效方法:

方法1:修改PlatformIO配置文件(推荐)

打开项目根目录下的 platformio.ini 文件,找到你对应的环境块(比如 [env:esp32dev]),添加一行 upload_port 配置,把你的端口号填进去:

[env:esp32dev]
platform = espressif32
board = esp32dev  ; 对应ESP Wrover 32的board配置,确保这里是正确的
framework = arduino
upload_port = COM3  ; Windows示例,替换成你的端口
; upload_port = /dev/tty.usbserial-1410  ; macOS示例
; upload_port = /dev/ttyUSB0  ; Linux示例

保存文件后,直接点击VSCode里的PlatformIO上传按钮即可。

方法2:在VSCode的PlatformIO面板里选择端口

  1. 点击左侧边栏的PlatformIO图标(那个小蚂蚁标志)
  2. 展开你的项目,找到「General」分类
  3. 点击「Upload Port」,在弹出的列表里选择正确的端口
  4. 之后再点击「Upload」按钮执行上传

方法3:命令行指定端口(确保命令正确)

之前你用命令行无效可能是语法不对,正确的命令应该是在项目根目录下运行:

# Windows示例
pio run --target upload --upload-port COM3

# macOS/Linux示例
pio run --target upload --upload-port /dev/tty.usbserial-1410

额外注意事项

  • 确认你的USB线是带数据传输功能的,有些廉价线只有充电功能,会导致无法识别端口
  • Windows用户如果设备管理器里端口显示黄色感叹号,需要安装对应的驱动(CH340或CP210x,根据你的ESP32串口芯片而定)
  • 可以试试重新插拔ESP32,或者重启VSCode后再尝试上传

内容的提问来源于stack exchange,提问作者Quentin Girault

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.19 09:41:30