超详细！VSCode+PlatformIO+Wokwi搭建ESP32仿真开发环境（零基础保姆级教程）-拓冰建站

很多新手入门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: }