上一节我们在 VSCode 内通过diagram.json实现 ESP32 仿真，但存在一个明显短板：VSCode 内置 Wokwi 插件仅能预览硬件，不支持鼠标拖拽添加元器件、手动连线，只能手动手写 JSON 配置，电路复杂时效率极低、容易写错引脚。

这里给大家一套高效 workflow：网页 Wokwi 可视化画电路 → 导出配置文件 → 复制到本地 PlatformIO 项目 → VSCode 本地编译仿真，兼顾可视化绘图与本地代码开发优势。

一、进入 Wokwi 在线官网

打开浏览器访问官方仿真网站：https://wokwi.com/

无需安装软件，浏览器直接使用，支持全可视化拖拽元器件、鼠标连线、实时串口调试。

选择esp32

二、新建 ESP32 工程

1. 进入首页点击「New Project」新建项目；

2. 在开发板列表中搜索并选择ESP32 DevKit C v4；

3. 网页会自动生成空白工程，包含：

• sketch.ino：在线端代码文件 sketch.ino(main.cpp)

• diagram.json：硬件电路、元器件、连线配置文件

三、可视化绘制电路（核心优势）

1. 左侧元器件库，搜索电阻、LED、传感器、显示屏等任意外设，拖拽到画布；

2. 鼠标点击元器件引脚，直接拖拽导线完成引脚连接，无需手动写引脚编号；

3. 可双击元器件修改参数（电阻阻值、LED 颜色、模块地址等）；

4. 网页自带仿真运行按钮，点启动即可在线测试代码与电路，串口输出实时查看。

整个过程完全可视化，比手写diagram.json高效数十倍，复杂传感器、多外设电路首选网页端绘制。

四、同步代码与硬件配置到本地 VSCode 项目

在线电路调试无误后，我们把网页文件迁移到本地 PlatformIO 项目：

1. 复制代码

• 网页端代码文件sketch.ino全部内容复制；

• 粘贴到 VSCode 项目src/main.cpp中，语法完全兼容 Arduino 框架，无需改动。

2. 复制硬件电路配置

• 网页侧边栏打开diagram.json，全选复制所有 JSON 内容；

• 覆盖替换本地项目根目录的diagram.json文件；

注意：本地wokwi.toml无需修改，依旧保持固件路径配置不变，只更新硬件电路图 JSON。

五、回到 VSCode 本地仿真运行

1. 保存修改后的main.cpp和diagram.json；

2. 点击底部对勾按钮编译项目；

3. 打开diagram.json文件(以记事本方式打开），VSCode Wokwi 插件会加载你在网页画好的完整电路、所有元器件与连线；

4. 点击绿色运行按钮，本地完成仿真，效果和网页端完全一致。

六、该方案优缺点总结

优点

1. 网页支持可视化拖拽连线，解决 VSCode 插件不能绘图布线的痛点；

2. 在线可快速调试电路逻辑，出错即时修改；

3. 本地 VSCode 负责代码管理、版本控制、完整 PlatformIO 编译工具链；

4. 一次绘图，本地永久保存，后续修改代码不用重新画电路。

小缺点

每次新增 / 修改硬件连线，需要重新在网页更新 JSON 并复制到本地，适合电路定型后长期本地开发。

七、完整使用流程梳理

1. VSCode 搭建 PlatformIO+Wokwi 基础环境（前文教程）

2. 打开 wokwi.com 在线网页，新建 ESP32 工程

3. 拖拽元器件、鼠标连线，编写测试代码在线仿真验证

4. 复制sketch.ino代码 → 本地src/main.cpp

5. 复制网页diagram.json→ 本地项目根目录覆盖

6. VSCode 编译，本地一键仿真运行电路