上一节我们在 VSCode 内通过diagram.json实现 ESP32 仿真，但存在一个明显短板：VSCode 内置 Wokwi 插件仅能预览硬件，不支持鼠标拖拽添加元器件、手动连线，只能手动手写 JSON 配置，电路复杂时效率极低、容易写错引脚。
这里给大家一套高效 workflow：网页 Wokwi 可视化画电路 → 导出配置文件 → 复制到本地 PlatformIO 项目 → VSCode 本地编译仿真，兼顾可视化绘图与本地代码开发优势。
一、进入 Wokwi 在线官网
打开浏览器访问官方仿真网站：https://wokwi.com/
无需安装软件，浏览器直接使用，支持全可视化拖拽元器件、鼠标连线、实时串口调试。
选择esp32
二、新建 ESP32 工程
进入首页点击「New Project」新建项目；
在开发板列表中搜索并选择
ESP32 DevKit C v4；网页会自动生成空白工程，包含：
sketch.ino：在线端代码文件 sketch.ino(main.cpp)diagram.json：硬件电路、元器件、连线配置文件
![]()
三、可视化绘制电路（核心优势）
左侧元器件库，搜索电阻、LED、传感器、显示屏等任意外设，拖拽到画布；
鼠标点击元器件引脚，直接拖拽导线完成引脚连接，无需手动写引脚编号；
可双击元器件修改参数（电阻阻值、LED 颜色、模块地址等）；
网页自带仿真运行按钮，点启动即可在线测试代码与电路，串口输出实时查看。
整个过程完全可视化，比手写diagram.json高效数十倍，复杂传感器、多外设电路首选网页端绘制。
四、同步代码与硬件配置到本地 VSCode 项目
在线电路调试无误后，我们把网页文件迁移到本地 PlatformIO 项目：
1. 复制代码
网页端代码文件
sketch.ino全部内容复制；粘贴到 VSCode 项目
src/main.cpp中，语法完全兼容 Arduino 框架，无需改动。
2. 复制硬件电路配置
网页侧边栏打开
diagram.json，全选复制所有 JSON 内容；覆盖替换本地项目根目录的
diagram.json文件；
注意：本地
wokwi.toml无需修改，依旧保持固件路径配置不变，只更新硬件电路图 JSON。
五、回到 VSCode 本地仿真运行
保存修改后的
main.cpp和diagram.json；点击底部对勾按钮编译项目；
打开
diagram.json文件(以记事本方式打开），VSCode Wokwi 插件会加载你在网页画好的完整电路、所有元器件与连线；点击绿色运行按钮，本地完成仿真，效果和网页端完全一致。
六、该方案优缺点总结
优点
网页支持可视化拖拽连线，解决 VSCode 插件不能绘图布线的痛点；
在线可快速调试电路逻辑，出错即时修改；
本地 VSCode 负责代码管理、版本控制、完整 PlatformIO 编译工具链；
一次绘图，本地永久保存，后续修改代码不用重新画电路。
小缺点
每次新增 / 修改硬件连线，需要重新在网页更新 JSON 并复制到本地，适合电路定型后长期本地开发。
七、完整使用流程梳理
VSCode 搭建 PlatformIO+Wokwi 基础环境（前文教程）
打开 wokwi.com 在线网页，新建 ESP32 工程
拖拽元器件、鼠标连线，编写测试代码在线仿真验证
复制
sketch.ino代码 → 本地src/main.cpp复制网页
diagram.json→ 本地项目根目录覆盖VSCode 编译，本地一键仿真运行电路