这是一张写给 ESP32 玩家的收藏凭证：从不花一分钱的浏览器仿真，到 30k Star 的 AI 聊天机器人，沿途二十个开源项目按难度排好站序，每个项目都配上官方原图，从适用场景、安装上手到开发要点分开讲清楚。

ESP32 # 开源项目 # 物联网

01 零成本热身：先仿真，再买板

很多初学者都卡在第一步：板子没到货、驱动装不上、杜邦线接错烧了模块。其实入门完全可以不花一分钱——先用仿真器把代码逻辑和电路连接跑通，再上手真机，学习曲线会平缓得多。

Velxio · 浏览器里的电子实验室（3000+ Star）

— Velxio 编辑器里的 ESP32 点灯工程

场景｜AGPL-3.0 协议开源的硬件仿真工具，把整套电子实验室搬进浏览器：不买开发板、不焊接线，打开网页就能写代码、搭电路、跑仿真。AVR 和 RP2040 板子直接在浏览器运行编译后的机器码；ESP32 系列通过后台 QEMU 虚拟机实时映射 GPIO 和串口；电路层集成 SPICE 引擎，实时计算电压电流，短路会报错。

安装｜零安装：浏览器直接访问 velxio.dev 即开即用。想本地部署就是一行 Docker（支持 Windows/Mac/Linux）；也可以从源码自行编译。注意：自部署版仅含 Arduino、Pico 和 ESP32 家族，STM32 与树莓派 Linux 需用官方在线版。

开发｜覆盖 40+ 开发板：全系 ESP32（含 ESP32-CAM、S3、C3）、Arduino Uno/Nano/Mega、树莓派 Pico，以及 XIAO、M5Stack 成品板。交互式元件很讲究：温湿度传感器用滑块调数值，电位器旋钮改阻值，超声波测距可拖动障碍物，按键甚至模拟了机械抖动。支持 Arduino C++、MicroPython、ESP-IDF 和 Python，顶栏集成库管理器一键装 Adafruit、U8g2。内置 400+ 示例工程，还导入了官方「100 天 100 个物联网项目」合集；浏览器内可搭虚拟网络，ESP32 能真实连 Wi-Fi、拿局域网 IP、对接公共 MQTT 服务器或 Home Assistant。项目地址：github.com/davidmonterocrespo24/velxio

— 内置示波器实时绘制引脚波形，支持 I2C/SPI 协议分析

docker run -d --name velxio -p 3080:80 ghcr.io/davidmonterocrespo24/velxio:master

小结：仿真练逻辑，真机验时序。射频、大电流驱动、真实时序抖动仍需实物验证，但 Velxio 已把入门试错成本压到了零。

02 地基工程：四套环境按需选

确定开发环境是第二个门槛。ESP32 生态有四条主流路径，对应不同的语言偏好和深度需求，建议从易到难逐级切换，而不是一开始就挑战最底层。

arduino-esp32 · 第一入口（17k+ Star）

场景｜乐鑫官方维护的 Arduino 核心库，全网教程、示例、第三方库几乎都默认跑在它上面——从 Blink 点灯到 Wi-Fi 扫描，写法与普通 Arduino 完全一致，是绝大多数人的第一个入口。支持 ESP32、S2、S3、C3、C5、C6、H2、P4 全系芯片。

安装｜打开 Arduino IDE 的开发板管理器，搜索 esp32 安装「esp32 by Espressif Systems」即可，选好板型插上 USB 就能烧录。

开发｜上层是熟悉的 digitalWrite、analogRead，底层封装的正是 ESP-IDF——想深挖时可以把它作为 ESP-IDF 组件混用，过渡无缝。地址：github.com/espressif/arduino-esp32

esp-idf · 官方框架（19k+ Star）

场景｜乐鑫官方 IoT 开发框架，基于 FreeRTOS 的 C/C++ SDK。想真正理解任务调度、外设驱动和分区表、想做出量产级产品，绕不开它。

安装｜访问 idf.espressif.com 按平台下载官方安装器（Windows/Linux/macOS），一条命令装齐工具链；命令行用户走 install.sh、source export.sh 的经典流程。

开发｜一条 idf.py 工作流贯穿始终：选芯片、图形化配置、编译、烧录、看串口一气呵成；仓库 examples 目录里还有上百个官方示例。地址：github.com/espressif/esp-idf

idf.py set-target esp32s3
idf.py menuconfig
idf.py -p /dev/ttyUSB0 flash monitor

PlatformIO · 统一 IDE（9.5k Star）

场景｜在 VS Code 里统一管理所有嵌入式开发：Arduino、ESP-IDF、MicroPython 多框架共存，依赖库自动拉取、单元测试、远程固件分发一站搞定，专业嵌入式团队的主力工具。

安装｜VS Code 扩展商店搜索 PlatformIO IDE 点击安装，初始化完成后新建项目、选 Espressif ESP32 加任意框架即可。

开发｜项目配置全部集中在 platformio.ini：板卡、框架、依赖、编译选项一行声明，环境可复制可版本化，告别「我电脑上能跑」。地址：github.com/platformio/platformio-core

MicroPython · Python 上芯片（22k Star）

— MicroPython：一只蟒蛇盘在芯片上的项目图腾

场景｜让 Python 3 直接跑在芯片上，REPL 交互式即敲即得：验证一颗传感器逻辑、给小朋友上硬件编程课、快速搭原型，都不用经历「编译—烧录—等待」的循环。ESP32 是它的一线支持平台。

安装｜micropython.org 下载 ESP32 通用固件，用 esptool 烧录；新手更推荐 Thonny IDE——菜单里选好板子，一键下载固件并自动连接。

开发｜machine 模块控制 GPIO、PWM、I2C、SPI，network 模块连 Wi-Fi，语法就是标准 Python；写完即跑，改完即测，原型效率天花板。地址：github.com/micropython/micropython

小结：Arduino IDE 起步、MicroPython 做原型、ESP-IDF 打通底层，PlatformIO 全程托管——这是社区最常见的一条进阶路线。

03 新手第一站：六个直观小项目

环境就绪，接下来挑几个代码量小、效果直观的项目建立正反馈。六个仓库正好覆盖点灯、拍照、配网、数据、输入、通知六个高频场景，每块几十元的开发板就能全部跑通。

WLED · 灯带玩法天花板（18.7k Star）

— WLED 网页控制台：200+ 灯效即点即亮

— 手机 App 随处可控

场景｜氛围灯、桌面矩阵、圣诞灯串、屏幕背光——用 ESP32 控制各类 RGB 灯带：WS2812B 等 40+ 灯型、2D 矩阵乃至 HUB75 面板，自带 200+ 内置灯效、50+ 调色板和声控灯效，还有手机 App 和语音控制。

安装｜全程不用写代码：浏览器打开 install.wled.me，选版本一键烧录；手机连上 WLED-AP 热点配网，进网页控制台点亮第一根灯带，是「成就感来得最快」的项目。

开发｜Usermod 插件机制让你不改核心代码就能扩展功能；JSON/HTTP API、MQTT、E1.31/Art-Net 全套接口，可接 Home Assistant、Alexa、diyHue 等生态。协议为 EUPL v1.2。地址：github.com/wled/WLED

esp32-cam-webserver · 十几元的网络摄像头

— README 首图的监控画面：其实画面里有两只猫

— AI-THINKER 模块与 FTDI 的接线图（README 详尽到这一步）

场景｜把十几块的 ESP32-CAM 模块变成 Wi-Fi 摄像头：监控、门铃、宠物观察、延时摄影。它在乐鑫官方例程上大幅扩展：浏览器配网、参数保存、补光灯控制、画面旋转、独立流查看器与 OTA 无线升级一应俱全。

安装｜下载 release 后把 myconfig.sample.h 复制为 myconfig.h 填入 Wi-Fi；FTDI 接线、GPIO0 接地进烧录模式，Arduino IDE 选 ESP32 Dev Module 加 Minimal SPIFFS 分区烧录。首次会发出 ESP32-CAM-CONNECT 热点，连上即可进入配置页。

开发｜官方例程里压缩成二进制的网页被解包成明文 HTML/CSS/JS，改界面就是改文件；仓库还带一份 API 文档（API.md）方便二次自动化。注意：该板对供电质量敏感，且单路流同时只支持一个观看端。地址：github.com/easytarget/esp32-cam-webserver

WiFiManager · 配网标配（7.3k Star）

场景｜任何联网项目都绕不开配网：把 Wi-Fi 密码写死在代码里，换个环境就失效。WiFiManager 让设备首次启动发射热点，手机浏览器里填好账号密码即可联网——几乎所有 ESP32 联网教程的标配。

安装｜Arduino 库管理器搜索 WiFiManager 直接安装；PlatformIO 用户在 lib_deps 里加一行即可。

开发｜核心用法只有三行；进阶还支持多凭据记忆、超时回退、带自定义参数的配置页（比如把 MQTT 地址一起填了）。地址：github.com/tzapu/WiFiManager

#include <WiFiManager.h>
WiFiManager wm;
wm.autoConnect("MyESP32-Setup");
// 连上后继续执行正常业务逻辑

ArduinoJson · JSON 必备库（7.2k Star）

场景｜对接天气、汇率等网络 API，读写设备配置，与 MQTT、Home Assistant 交换数据——嵌入式 JSON 处理是刚需。它比 Arduino 官方库小一半、快一成、省一成内存，单元测试覆盖率接近 100%。

安装｜库管理器搜索 ArduinoJson 安装（当前主版本 v7），无需任何依赖。

开发｜一个 JsonDocument 走天下：解析、生成、过滤、美化输出；还支持 MessagePack、外部 PSRAM 和流式读写。地址：github.com/bblanchon/ArduinoJson

JsonDocument doc;
deserializeJson(doc, json);
const char* sensor = doc["sensor"];
double latitude = doc["data"][0];

ESP32-BLE-Keyboard · 蓝牙宏键盘（3.2k Star）

场景｜把 ESP32 变成蓝牙低功耗键盘/鼠标：DIY 宏键盘、PPT 翻页器、游戏快捷键面板、自动打卡机，几十行代码就能落地，是 HID 入门首选。兼容 Windows、Android、Linux，还支持媒体键。

安装｜从 release 页下载 zip，Arduino IDE「项目—导入库—添加 .ZIP 库」即可；同作者还有鼠标版，社区另有游戏手柄版。

开发｜接口与 Arduino 官方 Keyboard 库几乎一致：print、write、press、releaseAll 换个名字就能用；开启 NimBLE 模式可省下约四成 Flash 和百余 KB 内存。地址：github.com/T-vK/ESP32-BLE-Keyboard

#include <BleKeyboard.h>
BleKeyboard bleKeyboard;
bleKeyboard.print("Hello world");
bleKeyboard.write(KEY_MEDIA_PLAY_PAUSE);

ESP-Mail-Client · 邮件通知

场景｜温度超限、门磁触发、浇花完成、摄像头抓拍上报——用一封邮件做最朴素也最可靠的 IoT 通知，不用依赖任何第三方推送平台。

安装｜库管理器搜索 ESP Mail Client 安装；示例覆盖 Gmail、Outlook、QQ 邮箱等主流服务，改几行账号配置即可发送。

开发｜支持 SMTP/IMAP/POP3 收发、SSL/TLS、附件与内嵌图片（ESP32-CAM 拍照直发邮箱是经典组合）、RFC 822 日期格式等细节全部处理好。地址：github.com/mobizt/ESP-Mail-Client

小结：这些项目的共同点是主程序几百行、改配置就能跑——把它们当「可运行的教材」来读，比看十篇教程都有用。

04 全屋智能：让家里活起来

当点灯不过瘾，下一个台阶是让整屋子设备听你的话。在这个领域 ESP32 几乎是事实标准，四个项目代表四种玩法：刷固件、写配置、做网关、离网通信。

Tasmota · 智能设备换芯（24.8k Star）

— 刷完固件首次启动的 Wi-Fi 配置界面

场景｜给智能插座、开关、灯具换上开源固件：WebUI 全图形化配置、规则引擎自动化、定时任务，MQTT/HTTP/串口全支持，完全本地控制、不依赖任何云——从此告别厂商停服变砖的焦虑。

安装｜浏览器打开 tasmota.github.io/install 用 WebInstaller 一键烧录；重启后连上它发出的热点填入家里 Wi-Fi（见配图），再到 templates.blakadder.com 按设备型号套用模板，几步完成「换芯」。

开发｜规则语法（如 ON Power1#state DO ...）就能写自动化；编译级定制走 user_config_override.h；还内嵌 Berry 脚本与 LVGL 显示支持。安全提醒：涉及市电的设备务必断电操作、不懂就找电工。地址：github.com/arendst/Tasmota

ESPHome · 写 YAML 不写 C（11.8k Star）

场景｜DIY 全屋传感器与执行器：温湿度计、继电器、灯串——用 YAML 描述引脚和元件，固件自动生成、Home Assistant 原生发现，一行 C 代码都不用写。

安装｜两条路任选：Home Assistant 用户直接装官方 ESPHome Builder 加载项（纯图形界面）；命令行用户 pip install esphome、esphome run desk-light.yaml 编译烧录一条龙。

开发｜500+ 现成组件（sensor、light、switch、display……），自动化逻辑、OTA 无线更新、Wi-Fi 凭据都写在 YAML 里；改完配置点一下就无线推送，维护设备像改配置文件一样轻松。地址：github.com/esphome/esphome

esphome:
  name: desk-light
esp32:
  board: esp32dev
light:
  - platform: neopixelbus
    name: "桌灯"

OpenMQTTGateway · 万物转 MQTT（4.1k Star）

— 一个网关桥接家里所有互不兼容的协议

场景｜把家里互不兼容的设备统一接入：BLE 温湿度计、433MHz 门磁、红外遥控、米家传感器，统统转成 MQTT 消息发布出去，是 DIY 网关里的瑞士军刀。

安装｜releases 页按板型和功能下载预编译固件（ESP32+BLE、RF、IR 等变体）直接烧录；想自定义裁剪则用 Arduino 或 PlatformIO 自行编译。

开发｜模块化框架按需开启 BLE、RF、IR、BT 桥；发布的数据遵循 MQTT discovery 约定，Home Assistant 自动识别、零配置接入。地址：github.com/1technophile/OpenMQTTGateway

Meshtastic · 离网电台（7.8k Star）

— Meshtastic：不靠基站的 LoRa mesh 网络

场景｜基于 LoRa 的远距离离网 mesh 通信：徒步、露营、应急场景里，ESP32+LoRa 电台组成去中心化网络互发消息、共享位置——没有基站也能通信，近年在户外圈和应急圈都很火。

安装｜meshtastic.org 的网页烧录器一键刷固件（支持 ESP32、nRF52、RP2040 等平台）；手机装 Meshtastic App 蓝牙配对即用，社区有大量现成整机（LILYGO T-Deck、RAK 等）。

开发｜固件、App、Python CLI、服务端全链路开源；关注频道加密、遥测上报、节点中继等玩法时，直接读它的协议文档就是最好的 LoRa 入门课。地址：github.com/meshtastic/firmware

小结：刷 Tasmota、配 ESPHome、进阶 OpenMQTTGateway、玩转 Meshtastic——四步走完，你对 IoT 协议栈的理解会超过大多数教程作者。

05 进阶与 AI 硬件：从玩家到创造者

最后一程是真正的「造物」：屏幕、触感、大模型。这一章的项目难度上了一个台阶，但也最接近做出别人愿意用的东西。

xiaozhi-esp32 · 小智 AI 聊天机器人（30k+ Star）

— 通过 MCP 协议，大模型得以控制扬声器、LED、舵机等硬件

— 面包板手工 DIY 版接线实拍，官方百科全书里有完整教程

场景｜虾哥开源的 ESP32 AI 聊天机器人（MIT 协议）：连上 Qwen、DeepSeek 等大模型就能语音对话，还能通过 MCP 协议控制灯、舵机、GPIO。AI 桌面机器人、语音助手、桌面宠物、儿童玩具——它是当下最火的 ESP32 项目，兼容立创实战派、ESP32-S3-BOX3、M5Stack 等 70+ 开发板。

安装｜新手走「免环境烧录」：下载 release 固件，用 Flash Download Tool 或网页烧录工具刷入，连上 xiaozhi.me 官方服务器即可开聊（个人可免费用实时模型）；想私有化部署，社区有 Python、Java、Go 多个开源服务端。

开发｜技术栈很有嚼头：ESP-SR 离线唤醒、OPUS 编解码、流式 ASR+LLM+TTS 架构、WebSocket 与 MQTT+UDP 双传输、声纹识别；支持 138 个板级目录，自定义开发板有官方文档。地址：github.com/78/xiaozhi-esp32

idf.py set-target esp32s3
idf.py build
idf.py flash monitor

LVGL · 嵌入式 GUI 之王（24.8k Star）

— LVGL：最流行的开源嵌入式界面库

— 官方演示界面：控件、动画、主题一应俱全

场景｜给设备装一块像样的屏：智能家电面板、桌面机器人表情屏、车表盘、工业 HMI——从单色屏到带 3D GPU 的芯片都能跑，想做带界面的产品绕不开它。

安装｜Arduino 库管理器或 PlatformIO 直接安装 lvgl；ESP-IDF 项目用 idf.py add-dependency 引入，几分钟就能点亮第一个 Hello World 界面。

开发｜C 接口的控件树加样式系统，动画、布局、中文字体方案齐全；配套的 SquareLine 工具可以拖拽式设计再导出代码。地址：github.com/lvgl/lvgl

smartknob · 力反馈旋钮（21k Star）

— 官方爆炸图：无刷电机、磁编码器、屏幕与旋钮帽层层可拆

场景｜软件定义端点的力反馈旋钮：无级旋转、虚拟卡点、按键手感全部由代码控制——HiFi 音量旋钮、智能面板旋钮的机械美学天花板。

安装｜软硬件全开源：KiCad 工程文件加 BOM 清单照单采买、打样焊接；固件用 PlatformIO 编译烧录，再用网页配置工具标定磁编码器即可。

开发｜ESP32 加云台无刷电机加 AS5600 磁编码器，固件里跑着 FreeRTOS 实时力矩环——想学电机控制就从读它的源码开始。地址：github.com/scottbez1/smartknob

esp-rs · Rust 上 ESP32（esp-hal 2k+ Star）

场景｜用 Rust 写 ESP32：内存安全、现代工具链（cargo、clangd、原生调试），适合追求可靠性的进阶玩家和想跨入 Rust 嵌入式的人。

安装｜cargo install espup 装 bootloader 工具链，再用 cargo generate 从官方项目模板一键生成可编译的 ESP32 工程。

开发｜esp-hal 提供 no_std 裸机 HAL，可配 embassy 异步运行时；esp-wifi 补齐 Wi-Fi/BLE 支持。地址：github.com/esp-rs/esp-hal

小结：小智证明了：一块几十块的开发板加一个大模型，就能做出让三万人围观的 AI 硬件。

06 把六个站串成一条路

完整路线是这样的：先用 Velxio 在浏览器里跑通「100 天 100 个物联网项目」的示例，理解代码与电路的关系；再用 Arduino IDE 配合 WLED 和 ESP32-CAM 完成真机首秀；然后刷 Tasmota、写 ESPHome，把家里的设备纳入掌控；最后带着 LVGL 和 xiaozhi-esp32 去造自己的产品。

每一步都只引入少量新概念，踩坑成本被切得很薄。开源项目的 README、Issues 和 Discussions 本身就是最好的教材——遇到问题先搜 Issue，再自己提，你的疑问大概率早有人踩过。

提醒：仿真先行、真机验证、小步快跑——这条路上没有捷径，但每一步都有现成的开源代码铺路。

你的第一块开发板，就是 20 元的物联网世界入场券。文中全部项目开源免费、原图与地址均取自官方仓库——从今天起，缺的只是一块板子和一点好奇心。

ESP32 # 开源项目 # 物联网 # AI 硬件