先交个底：我手上一块 ESP32 都没有。
但为了写这篇，我把 GitHub、Reddit、Hacker News、V2EX、LINUX DO、X、B站、YouTube 翻了一遍。光 Reddit 的 r/esp32 一个版块，最近半年就有 7,930 个帖子。
翻完我最大的感受是：这块板子便宜得离谱，可小白翻车的地方，几乎都不在板子上。
所以这篇只做一件事：给你一条最稳的上手路线。每一步附官方教程和“过关标准”，每个坑附踩坑那个人的原帖，文末再给 14 个我筛过的项目。
中间还有一个我这次翻到的最离谱的故事：有人用 AI 不到 24 小时做出了语音机器人，然后花了整整两周，去找一个 bug。那个 bug 有多大？我放在后面说。
没实测过的地方，我不装实测过。
先说两个人
今年 9 月，LINUX DO 上有位网友听了 ChatGPT 的建议，一口气下单了 ESP32-S3、超声波测距模块、电机驱动板、小车底盘、降压模块、面包板、杜邦线，外加 18650 电池。
东西全到了，他傻眼了：找不到对应的教程，连接线都费劲。他在帖子里自嘲：“这不是玩，这是入行啊！！！”（原帖）
同一个月、同一个论坛，一位非技术出身的家长晒了给孩子做的 ESP32 电子宠物。孩子会通过它留几句话，他也能回。他说自己“都是跟 AI 对着改，改到能用”。（原帖）
有意思的是，给孩子用的那台，他买的是现成、带电池的板子。
两个人都不是工程师。在我看来，差别不在技术，在路线：一个先买零件，再想能做什么；一个先想好做什么，再挑能直接用的硬件。
这篇后面所有内容，其实都在展开这一句。
先拆一个误会：AI 不住在板子里
很多人以为，买块 ESP32，就等于把 AI 装进去了。
拿小白最常复刻的开源项目小智 AI 来说：唤醒词是在板子上离线识别的；你一开口，声音就以音频流传到服务器，听懂、想答案、再变成语音，都是服务器在干。固件默认连的是小智官方服务器 xiaozhi.me。（小智 README）
打个比方，ESP32 像餐厅门口的点餐机，负责收你的话、给你出声、亮个屏。菜是后厨做的，后厨就是云端的大模型。
还有个更极端的例子。10 月 11 日，X 上有条帖子说，一块 7 美元的 ESP32 能让 AI 操作一台普通 iPhone，我采集时已经有 15.5 万浏览。（原帖）
但作者自己写得很清楚：演示用的模型，跑在他本地的 2 台 DGX Spark 上。ESP32 在里面，只当了一回 USB 键盘鼠标。（项目）
7 美元的板子，背后站着两台 DGX Spark。
便宜的是板子，难的是把“听、想、做、反馈”这一整圈跑通。
那问题来了：一个完全不懂嵌入式的人，到底该怎么开始？
这个问题我想了挺久。把翻到的帖子归了归，最后就剩 4 条。每一条背后都有真实的人，有的做成了，有的翻车了。
一、先有项目，再买板子
开头那位网友踩的坑，我给它起了个名字，叫散件陷阱：先把零件买齐，再去想能拿它们干什么。
这个坑不分中外。Reddit r/esp32 上，一位新手晒了一桌子零件，问该从哪开始，帖子拿了 797 分、236 条评论（存档时数据）。有条回复反问得特别实在：你为什么买了这么多块 ESP32？先从一块开始。（原帖）
路线大概就三条：
- 买成品，刷开源固件。适合只想用、不想接线的人。比如 CrossPoint Reader，专门给 Xteink 这类成品墨水屏阅读器刷开源固件，代价是只支持它列出来的设备。
- 买项目支持的一体开发板，刷现成固件。这是我最推荐小白走的路，后面都按它讲。
- 自己买零件组装。前提是你手上已经有一份能照着做的教程，不然就是开头那位的处境。
为什么推荐第二条？小智的 README 写着，目前支持 138 个板卡目录、171 个固件变体，立创·实战派 ESP32-S3、乐鑫 ESP32-S3-BOX-3、M5Stack CoreS3、微雪 ESP32-S3-Touch-AMOLED-1.8 都在列。README 还专门叮嘱：新手第一次操作，先别搭开发环境，直接用免开发环境烧录的固件。（小智 README）
翻译一下：只要板子在列表里，你一行代码都不用写。
还有个小发现。我翻到的几个做成了的例子，没有一个是从散件开始的：
- 那位家长，给孩子用的是现成带电池的板子。（原帖）
- 有人在闲鱼买了带屏的 ESP32，“商家给焊好的”，做成了桌面 token 用量监控。（原帖）
- X 上的 @Jack_FluxAI 零基础用 Claude Code 改刷的，是现成的小智模块。（原帖）
就 3 个样本，当不了规律。但我给自己定的规矩是：能买焊好的，先别自己焊。
具体买哪款，我不点名。我没有实机，点了就是瞎推。但挑板子的标准，我可以把自己会用的那几条摊开：
- 名字对得上支持列表。商品标题里的型号，要能在小智的固件列表里找到对应的那一项。文档说得很直白：选错固件可能跑不起来，屏幕也不亮；不在默认支持里的板子，要改源码重新编译。（小智烧录文档）
- 麦克风和喇叭是板载的。做语音助手，这两样缺一样都白搭。屏幕不是必须的，验证码也能靠喇叭播出来；但我会倾向带屏的，验证码和连接状态能直接看到。文档还提到，有些开发板的 RGB 灯开关没焊，买前最好看看详情图或问问卖家。（小智配网文档）
- 芯片优先 ESP32-S3。README 点名的那几款，清一色都是 S3。文档也写了，ESP32-C3 系列这类没有离线唤醒的板子，只能靠按键唤醒。
- 有一份带截图的中文教程。立创·实战派那份小智教程就是这个样子，可以先翻一下，感受这类板子上手大概什么样。（立创教程）挑的时候找有类似教程的型号，卡住了才有地方对照。
- 下单前问卖家三句话：是焊好的成品吗？预装小智了吗？能给原理图和出厂源码吗？预装了，后面的五关能直接跳到配网；原理图和源码，是 @Jack_FluxAI 总结的改刷前提，以后想改才有底。
板子之外，家里还得备好三样：
- 一台能装 Chrome 或 Edge 的电脑。网页烧录要用，文档写的是这两个浏览器“已验证”。
- 2.4G 的 Wi-Fi。小智配网只支持 2.4G。
- 一根能传数据的 USB 线。
最后这条，得单独拎出来说。
你以为最难的是写代码？小智官方文档里专门写了一句：不能用那种 2 芯的普通 USB 充电线。（小智烧录文档）Reddit 上也有人折腾了一大圈连不上电脑，最后发现是线的事。（Reddit）
一根线。真的就一根线。
价格我就不写了。没有带日期的来源，写了也是过两周就过时。
要是你已经乱买了一堆，也别慌。中文社区给过一个特别实际的办法：开视频让豆包帮你认零件，再把结果喂给 AI，问能拿它们做什么。（原帖）认完了，挑一块板子，回到上面，先找一个支持它的项目。
还没决定要不要玩？那就先点个灯。
LINUX DO 上有人问：“一块 ESP32 加一个啥也不会的人，接下来该干什么？”回复里有 3 个人提到同一个第一步：点灯，也就是让板子控制一颗 LED 闪烁。（原帖）
没板子也能点。velxio.dev 能在浏览器里模拟 ESP32 DevKit 这类板子，不用装软件，自带闪灯示例。（Velxio）它测不出线和供电的问题，但能让你在下单前先搞清楚：自己到底喜不喜欢这件事。
二、先用官方服务跑通，再谈自建
板子刷好以后（具体怎么刷，后面动手篇单独讲），第一个选择题就来了：用官方服务，还是自己搭？
小智 README 写得很清楚：固件默认接入 xiaozhi.me 官方服务器，个人注册账号可以免费用 Qwen 实时模型（截至 10 月 13 日，以官方为准）。社区里也有好几个自建服务器的开源方案。（小智 README）
你可能会想：自己搭的，总比公共的稳吧？
那位做电子宠物的家长，一开始就是这么想的。他觉得小智公有云上的服务不太稳，干脆自己搭了个服务器，接各种大模型和语音服务。结果按他自己的说法，现在“token 消耗起飞了”。（原帖）
更狠的是同一帖下面的回复。有人用了最便宜的服务器，说话“卡卡的也很慢”；还有人直接放弃了，嫌本地部署的“智商太低了”，调 API 又“响应太慢”。
最后连发帖人自己都说，小智官方的云“优化的挺好的”，他拿它当对标。
嚯，绕了一圈，标杆还是官方那个。
先用官方服务跑通，确认自己真的天天在用，再考虑自建。
真打算天天用之前，我会先想清楚三件事：
- 隐私。唤醒之后的语音会传到服务器处理，别把它放在你不想被录音的地方。
- 费用。官方服务目前对个人免费；自建服务器、第三方大模型 API，都是自己掏钱。
- 预期。有人吐槽过，ESP32 这类设备的麦克风拾音效果一般。（原帖）
三、动手改之前，先留一个存档点
打过游戏的都懂：打 Boss 之前，先存档。
折腾硬件也一样。最怕的不是改坏，是改坏了回不到能用的状态。
所以板子第一次跑通，我会立刻记下三样东西：板子型号、固件文件名（带版本号）、下载地址。以后改崩了，照着这张小纸条刷回去就行。
要是你改的是一台现成产品，不是空白开发板，那还得多一步：先备份原厂固件。烧录会覆盖板子上原来的固件，覆盖了就没了。
@Jack_FluxAI 的经验是先备份整片 Flash，16MB 大概要半小时。（原帖）不想装软件的话，ESPConnect 能直接在浏览器里备份分区或指定区域的 Flash。
半小时，换一条后路。
改坏不可怕，回不去才可怕。
四、AI 帮你跑完前 90%，后 10% 得你自己盯着
好了，终于到大家最想问的：能不能让 AI 帮我改？
能。不过在碰代码之前，还有一步很多人会跳过。
不写代码，也能把设备改成“你的”。xiaozhi.me 控制台里能设置智能体的角色；README 写着，唤醒词、字体、表情、聊天背景，都能在网页上在线改。先把这些玩明白，再碰代码也不迟。
真要碰代码，得先搞懂一件事：AI 的“手脚”在哪。
小智 README 里有一句我觉得特别关键：设备端可以通过 MCP 协议控制音量、灯光、电机、GPIO 这些东西。翻成大白话：大模型在云端想好要干什么，ESP32 负责真的去干，亮灯、转电机、按按钮。
LINUX DO 上就有人说，自己完全不懂 C 和 Python，也让 ESP32 控制舵机，按下了物理按键。（原帖）
那要不要先学点基础？这事社区真吵过。还是那个“一块 ESP32 加一个啥也不会的人”的帖子，回复里大致分成了三派（原帖）：
- 结果导向派：只要懂需求，能判断 AI 做出来是好是差，就够了。
- 基础派：先学到点灯，才能跟 AI 说上话。有人说得特别直白：“ai总不能帮你插引脚吧”。
- 科班派：ESP32 只是“玩具级别”，真想学嵌入式，得从 STM32 入手。
我的选择是结果导向，但留一条底线：至少会点灯、认得引脚。毕竟插引脚这件事，AI 真替你干不了。
再看看做成的人，是怎么用 AI 的：
- 那位家长：“跟 AI 对着改，改到能用。”
- 做 token 监控摆件的那位：烧录“全程是让 Codex 帮忙搞的”。不过 Codex 搞了好几次没弄好，最后换 Opus 5 才弄好。（原帖）
- @Jack_FluxAI：零基础用 Claude Code 改刷小智模块，帖子有 7,038 浏览、106 收藏（10 月 13 日采集）。他总结了三条：找卖家要原理图和出厂源码；动手前先备份整片 Flash；用能直接操作终端的 AI。（原帖）
看到这，你可能觉得稳了，交给 AI 就行。
真正离谱的在后面。
V2EX 上有位叫 lerry 的作者，写了我这次翻到的最完整的一个反面案例。（原帖）
他做的是语音对话机器人。方案、选零件、写代码都交给 AI，连电烙铁怎么用都是 AI 教的。不到 24 小时，语音对话就跑通了。
然后他花了两周查一个破音。换喇叭、换电源、查 Wi-Fi 干扰、查 DMA 缓冲区，全都没用。
最后发现，是一行 C++ 的类型问题。而且这个 bug，是 AI 在某次重构时自己引进来的。用他的话说：“改一个字符，问题消失。”
不到 24 小时跑通。两周排错。一个字符。
对，你没看错。
他最后的总结，我原样抄过来：
“AI 可以帮你做很多事情，但它无法替代你的判断力。”
同一个帖子里，还有两个人讲了差不多的经历。一位让 AI 半天就生成了能跑的代码，后来花了三天才查出来，AI 调用了一个有 bug 的旧接口；另一位做音频应用，推进到 90% 左右就卡住了。
这里得说句公道话。这帖发于今年 3 月，lerry 用的是当时的 ChatGPT 5.4 和 Claude 4.6，模型之后一直在进步。
但转念一想，换模型也不是万能药。他用的，已经是当时最好的那几个。
我管这叫最后 10%：AI 帮你飞快走完前面那段路之后，剩下的、只有你自己能判断对不对的那点活。
如果是我上手，给自己定的规矩就三条：
- 一次只改一处，改完立刻上真机试。
- 改之前，先确认存档点还在。
- 让 AI 先讲方案再动手，并让它加日志。改没改好，看真机，不看 AI 说“改好了”。
lerry 那帖的回复里，还有几条让 AI 帮忙排错的建议：多打日志；给项目加上代码审查和测试，让 AI 自己能发现重构带来的问题；把修复前的版本，拿给不同的模型审一遍。这些是网友的建议，我没看到有人验证过效果。
当然，也有人觉得这一整套都多余。
token 摆件那个帖子下面，有人说：“感觉没必要啊，纯软件就能实现的功能。”作者回得特别坦白：只是想用硬件显示一下，娱乐而已。（原帖）
V2EX 也有人说，完全靠 vibe coding 做硬件，就是“概率稍大点的老虎机游戏”。还有一句挺扎心：“很多老板只看到了前面不到 24 小时能把东西弄出来，意识不到后面可能要花两周去排查 bug。”（原帖）
咋说呢，这些冷水都对。想清楚了还想玩，那就是真喜欢。
动手篇：五关，每关都有过关标准
道理讲完了，下面是真动手的部分。
我一直觉得，小白最难受的往往不是哪一步难，而是做完了，不知道自己做没做对。
所以我按小智官方的烧录文档和配网文档，把整个流程拆成 5 关，每一关都写清楚做到什么样才算过。卖家要是说已经预装了小智，直接跳到第 4 关。
官方给了三种烧录方式：Windows 上用乐鑫的 Flash 下载工具、浏览器打开乐鑫的 ESP-Launchpad、第三方网页工具。下面按网页烧录讲，它要装的东西最少。
每过一关，先确认真过了，再往下走。
第 1 关｜下载对的固件
到官方的固件列表里，按你的板子名称找。注意，开发板的名字可能写成拼音或英文。
下载解压后，会得到一个 merged-binary.bin，放的路径里别带中文。
第 2 关｜让浏览器看见板子
用能传数据的线把板子连上电脑，有的板子要先打开电源开关。Windows 上打开“设备管理器”，在“端口（COM 和 LPT）”里应该能看到一个新端口；分不清是哪个，就拔下来再插上，看哪个消失又出现。
如果板子用的是 CH340、CH343 或 CP210x 这类串口芯片，可能要先装驱动，小智文档里附了沁恒驱动的下载地址。Mac 上怎么确认端口，文档没写，我也没找到官方说明。
然后用 Chrome 或 Edge 打开 ESP-Launchpad，切到 DIY 页面，点右上角的 Connect，在弹窗里选你的端口，点“连接”授权。
过关标准：网页上出现“Connected to device: ESP32-S3”，Connect 按钮变成 Disconnect。
这一关最容易卡住的几个地方：
- 弹窗里压根没有设备。官方给了三个原因：接口插错、端口选错、串口被电脑上别的软件占着。先把其他串口工具和网页关了再试。
- 两头都是 C 口的线，插上不通电。Reddit 上有人换成一头 A 口、一头 C 口的线就好了。（Reddit）
- 板子上有两个 USB 口。小智文档里的示例板，C 口朝下时右边是 UART、左边是 USB；别的板子以丝印上的 COM 标识为准。
- 进不了下载模式。按住 BOOT 不放，再按一下 RST（大概 0.5 秒），然后松开 BOOT。乐鑫文档解释过：有些板子没有自动复位的线路，得手动进。（乐鑫烧录故障排除）
第 3 关｜烧录
选上 bin 文件，Flash Address 填 0x0，点 Program。小智固件已经合并成一个 bin 了，不用再加别的文件。注意，烧录会覆盖板子上原来的固件。
等控制台显示写入 100%，出现“Leaving...”，就写完了。
但这还没完。官方文档特意提醒：烧录完，设备不会自己重启。得点网页上的 Reset Device，再点 Confirm。
过关标准：重启后，日志里出现 Wi-Fi 配网提示，设备进入配网模式。
卡住的话：
- Program 按钮是灰的：先看网页上有没有显示 Connected；再刷新页面，或者断开重连；还不行就换个浏览器。
- 刷完不停重启，或者出现 E 级报错：多半是固件和板子不匹配，回第 1 关重选。
第 4 关｜配网
进入配网模式后，官方示例板上的 RGB 灯会一直闪蓝。用手机或电脑连上设备发出的“Xiaozhi-XXXX”热点，配网页面会自己弹出来；没弹的话，就在浏览器里打开 192.168.4.1。
从列表里选你家的 Wi-Fi，输密码。只支持 2.4G；用 iPhone 热点的话，要把“最大兼容性”打开。
过关标准：页面提示配网成功，设备 3 秒后自己重启，之后自动连上你的 Wi-Fi。
卡住的话：
- 找不到 Xiaozhi 热点：先确认烧录成功、灯在闪。官方文档还提到，部分商家批次的板子可能有质量问题，Wi-Fi 信号不稳，可以先拿到离路由器近的地方试试。
- 想重新配网：较新的固件，开机后按住 BOOT 键就行。
第 5 关｜绑定，说第一句话
说一声“你好，小智”把它叫醒，它会播报或者在屏幕上显示一个 6 位验证码。没有离线唤醒的板子，比如 ESP32-C3 系列，用按键唤醒。
用电脑浏览器打开 xiaozhi.me，注册账号，然后“新建智能体”，再“添加设备”，输入那 6 位数字。
过关标准：完整完成一次对话，你说一句，它回一句。屏幕上只显示“已连接”，不算。
没听到验证码播报的话，先查喇叭；用第三方开发板的，查固件是不是选对了。
卡住了，先别慌
先给你吃颗定心丸。r/esp32 从 4 月 13 日到 10 月 13 日一共 7,930 个帖子，其中 1,671 个是求助帖（Arctic Shift 存档数据）。差不多每 5 个帖子里，就有 1 个在喊救命。
卡住，太正常了。
排查顺序我建议固定下来：供电 → 数据线 → 端口 → 固件 → 网络 → 服务 → 外设。前面五关下面列的卡点，基本都能按这个顺序对上号。
再补一条前面没写的：对话又卡又慢，如果用的是自建服务，先切回官方服务对比一下。（原帖）
不管是去论坛求助还是问 AI，我都会把这几样一次说清楚：
- 板子型号（商品标题原文）
- 项目和固件版本
- 电脑系统和浏览器
- 本来应该怎样，实际怎样
- 已经试过什么
- 日志或截图（遮住密码和 token）
问 AI 的时候，最后再加一句：先解释你打算怎么改、会动哪些文件，等我确认再改，每次只改一处。
几条安全底线
- 不碰 220V 市电。
- 锂电池选带保护板的，充电时别离人，摸着明显发烫就先断电。
- 截图、日志、视频发出去之前，遮住 Wi-Fi 密码、账号和各种 token。
- 固件只从官方或可信的来源下。ESPConnect 的说明里也这么提醒。
- 攻击、干扰类的 ESP32 固件，比如 Wi-Fi 干扰、蓝牙干扰工具，我一个都没收，有法律风险。
- 让 AI 碰你的设备之前，想清楚它能碰到什么。像 iPhone Agent 这种让 AI 操作整台手机的项目，看看就好，小白别急着复刻。
14 个项目：先看能不能做，再看热不热
数据都是 10 月 13 日采集的，口径放在这一节最后。
照着就能做的
- 小智 AI：ESP32 语音 AI 助手，中文资料最多。要准备支持列表里的板子，对话走云端。难度低。GitHub 30,842 星，近 30 天新增约 1,027。想看视频的话，B站《手把手教你复刻AI小智》37.6 万播放，《ESP32S3搭建小智AI（有手就会版）》23.5 万，《4分钟搭建ESP32-AI小智》15.0 万；前两个是 2025 年发的，版本可能已经变了。
- CrossPoint Reader：给 Xteink X4/X3 这类成品墨水屏阅读器刷开源固件，README 推荐用网页安装器。难度低。8,325 星，近 30 天约 +559。
- WLED：用 ESP32 控制 RGB 灯带，在手机网页上调光。要另外准备灯带和合适的电源，安装方式看官方文档。难度低到中。18,808 星。
- ESPHome：用配置文件把传感器、灯接进家庭自动化，通常要配合 Home Assistant 用。难度中。11,847 星。
- ESPConnect（工具）：浏览器里的 ESP32 控制台，能看板子信息、备份、刷写，要用 89 版以上的 Chrome、Edge 这类浏览器。难度低。2,173 星。
动一点手，适合当第二个项目的
- ESP32 Plane Radar：桌面圆屏，显示头顶飞过的实时航班。README 写明按 BOOT/RESET 进下载模式后，用 Chrome 或 Edge 刷。难度中。1,047 星；同题材在 Reddit 有 1,190 分的帖子，LINUX DO 上也有人分享浏览器直刷。
- AI 用量摆件，比如 Clawdmeter：桌面小屏显示 Claude Code 用量，要准备对应的屏幕板。难度中。2,256 星；LINUX DO 上也有人做了 token 消耗监控，标题写着花了 30 块钱。
- esp32-weather-epd：低功耗墨水屏天气站，要接线，还得选对屏幕和电池。难度中到高。6,306 星。
- CYD（Cheap Yellow Display）：便宜的带触摸屏 ESP32 板，加上围绕它的一堆社区项目。克隆板之间有差异，买前看社区说明。难度中。4,522 星；YouTube 相关视频 35.3 万播放。
- ESP32-C3 Adblock：用 ESP32-C3 做一个去广告的 DNS。要改路由器的 DNS 设置，出问题会影响全家上网。难度中。2,989 星；Hacker News 195 分。
看看就好的
- ESP32 iPhone Agent：就是开头那个。发布两天 1,020 星，原帖 15.5 万浏览。
- esp32-ai：真在芯片上跑了一个 28.9M 参数的小模型。作者说明它不能问答，也不能听指令，这正好说明了“板子上本地跑模型”的边界在哪。4,512 星；Hacker News 289 分。
- 大厂下场：Meta 的 Muse Gadgets SDK（要 SDK token，2,087 星）、乐鑫的 ESP-Claw（面向开发者的设备端 Agent 框架，2,229 星）、Anthropic 的 Claude Desktop Buddy（依赖 M5StickC Plus 和开发者模式，2,643 星）。
- Show HN：用 1,600 美元的 ESP32 换掉 12 万美元的保龄球馆系统：工程级项目，当“上限”看。2,935 分、359 条评论，是我用 HN Algolia 检索到的近一年 ESP32 相关帖子里分最高的。
还想多看点的
数据口径：GitHub 星数是 GitHub API 当天的值；近 30 天新增来自 OSS Insight，可能偏低，只看趋势；Reddit 分数是 Arctic Shift 存档时的，不是实时；X 是 FxTwitter 采集时的；B站和 YouTube 播放量是用 yt-dlp 抓的；LINUX DO 没拿到互动数据。
最后
乱七八糟写了这么多。一个手上一块 ESP32 都没有的人，在这教你怎么玩 ESP32，想想也挺抽象的。
但也正因为没有板子，我才只敢写有出处的东西。这篇里的每一步，背后要么是官方文档，要么是某个真实的人踩过的坑。
你照着做的时候要是发现哪儿不对，或者踩了文里没写的坑，回复里告诉我。我补进下一版，注明是你发现的。
别急着做机器人。
先做出一个你愿意每天用的小东西。做出来了，发我看看。
