很多新手入门ESP32开发，会纠结开发环境搭建繁琐、硬件调试麻烦、报错多等问题。今天给大家分享一套纯VSCode端、无需实体硬件、支持在线仿真的ESP32开发环境搭建方案，搭配PlatformIO+Wokwi插件，零基础也能一键搭建、快速运行测试程序。

本教程全程图文实操，步骤完整，亲测可用，适合ESP32入门开发者收藏学习！

一、前期准备工作

在开始搭建环境前，需要提前安装好两款基础软件，保证后续插件和项目正常运行：

• Python：必备运行环境，建议安装官方最新稳定版，安装时勾选自动配置环境变量

• VSCode（代码编辑器）：轻量高效的代码编辑工具，后续所有开发操作均在此软件内完成

二、安装核心开发插件

打开安装完成的VSCode软件，安装两款核心插件，是ESP32开发和仿真的关键：

1. 进入插件市场

点击VSCode左侧侧边栏的插件图标（扩展），在顶部搜索框中搜索对应插件名称。

2. 安装两款必备插件

• PlatformIO IDE：嵌入式开发核心插件，支持多单片机开发、项目编译、固件生成，替代传统Arduino IDE

• Wokwi：在线仿真插件，无需实体ESP32开发板，即可实现代码仿真运行、效果预览

搜索到插件后，点击安装即可，安装完成后重启VSCode确保插件生效。

三、创建ESP32 PlatformIO项目

1. 打开PlatformIO面板

VSCode左侧会出现蚂蚁头样式的PlatformIO图标，点击进入插件主面板。

2. 新建ESP32项目

选择面板中的 New Project（新建项目），进入项目创建界面：

• 自定义项目名称

• 开发板选择：ESP32（nodemcu-32s通用型号）

• 默认勾选相关配置，点击 Finish 开始自动下载核心依赖和固件包

重要注意事项：项目依赖下载必须使用手机热点网络！普通家庭路由器WiFi大概率下载失败、超时报错，切换热点即可完美解决。

四、配置Wokwi仿真文件

项目创建完成后，需要手动新建两个仿真配置文件，实现ESP32板子仿真展示和固件关联。

1. 新建 wokwi.toml 配置文件

在项目根目录下，创建名为 wokwi.toml 的文件，写入以下配置代码：

[wokwi]
version = 1
firmware = ".pio/build/nodemcu-32s/firmware.bin"
elf = ".pio/build/nodemcu-32s/firmware.elf"

2. 新建 diagram.json 硬件配置文件

同样在项目根目录下，创建名为 diagram.json 的文件，写入硬件仿真配置：

{
  "version": 1,
  "author": "youren",
  "editor": "wokwi",
  "parts": [
    { "type": "board-esp32-devkit-c-v4", "id": "esp", "top": 0, "left": 0, "attrs": {} }
  ],
  "connections": [
    [ "esp:TX", "$serialMonitor:RX", "", [] ],
    [ "esp:RX", "$serialMonitor:TX", "", [] ]
  ]
}

该文件作用：配置仿真硬件为ESP32开发板，配置串口通讯引脚，保障串口打印功能正常使用。

五、编写测试代码并编译运行

1. 写入ESP32测试代码

打开项目 src 目录下的 main.cpp 主程序文件，替换为以下基础测试代码，实现串口打印文字功能：

#include <Arduino.h>
void setup() {
  Serial.begin(115200);
  Serial.println("Hello ESP32");
}

void loop() {
  // put your main code here, to run repeatedly:
}

2. 项目编译

点击VSCode底部状态栏的对勾图标（编译按钮），开始自动编译项目。等待控制台提示编译成功，无报错即可。

3. 仿真运行程序

1. 编译完成后，点击打开项目根目录的 diagram.json 文件，界面会自动加载出ESP32仿真开发板；

2. 点击页面中的绿色启动按钮，运行仿真程序；

3. 打开串口监视器，即可看到成功打印 Hello ESP32，程序运行正常！

六、总结

至此，VSCode+PlatformIO+Wokwi 的ESP32仿真开发环境就完全搭建完成了。这套开发方案相比传统Arduino IDE，代码体验更好、项目管理更规范、无需实体硬件即可调试，非常适合新手入门学习ESP32开发。

后续所有ESP32项目开发，均可基于此环境编写、编译、仿真调试，高效便捷！

常见问题解决

• 依赖下载失败：切换手机热点重新下载；

• 编译报错：检查文件命名、代码格式，确保配置文件放置在项目根目录；

• 仿真无效果：确认wokwi插件已启用，重新编译项目后再次启动仿真。