经常有人问我想学 MicroPython 第一块开发板怎么选。我一般会直接回答把预算放在 ESP32 上优先挑微雪这类资料齐全、引脚标注清楚的开发板。原因很简单——ESP32 自带 Wi-Fi 和蓝牙几十块钱就能做联网设备而 MicroPython 的交互式开发环境又大幅降低了试错成本这套组合非常适合系统地入门嵌入式。这篇是这个系列的第 01 篇内容非常明确把 ESP32 是什么讲清楚把 MicroPython 开发环境从零配好最后让一个板载 LED 跑起来并实现常说的断电运行。零基础可以顺着文章一步步做Arduino 转过来的朋友也能在里面找到一些平时容易忽略的细节。整个系列后面会陆续展开传感器、外部中断、Wi-Fi、MQTT 这些方向这篇算是地基。1. 先搞清 ESP32 是什么一颗芯片通吃入门和量产1.1 ESP32 不是一块板子而是一个芯片家族很多新手会直接说我买了个 ESP32其实这句话不太严谨。ESP32 是乐鑫Espressif设计的一系列 SoC 芯片我们拿到手的开发板本质上是这颗芯片加上了电源电路、USB 转串口芯片、Flash 存储、天线以及各种引脚排针之后做出来的成品。打个比方芯片是发动机开发板是装好轮子的整车。微雪、乐鑫官方以及其他第三方厂商做的都是后一件事。为什么这个区别很重要因为你后面写 MicroPython 代码时很多问题其实和这颗芯片本身的特性有关。比如不同型号的芯片引脚数量不一样、硬件外设数量不一样甚至有些芯片型号对某些传感器库的支持也不一样。先分清芯片再去看板子查资料的时候就不会一头雾水。1.2 常见型号怎么选ESP32、S2、S3、C3、C6市面上最常遇到的 ESP32 系列有这么几类我列个表方便对比芯片型号内核无线能力适合场景经典 ESP32双核 Xtensa LX6240MHzWi-Fi 4 蓝牙 4.2通用入门、蓝牙相关项目、教程资料最多ESP32-S2单核 Xtensa LX7240MHzWi-Fi 4无蓝牙USB 外设键盘、鼠标、U 盘模拟、低成本纯 Wi-Fi 项目ESP32-S3双核 Xtensa LX7240MHzWi-Fi 4 蓝牙 5.0AI 视觉、屏幕 UI、复杂逻辑带向量指令加速常带 PSRAMESP32-C3单核 RISC-V160MHzWi-Fi 4 蓝牙 5.0低成本物联网节点、简单传感器采集ESP32-C6RISC-V160MHzWi-Fi 6 蓝牙 5.0 802.15.4Thread、Zigbee 协议相关新一代低功耗联网如果你完全没概念我建议初学者优先选经典 ESP32 或者 ESP32-S3。经典款的好处是教程最多你随便搜一个报错都有人遇到过S3 则是目前资料增速最快、新项目最多的型号而且很多开发板直接板载了屏幕或者摄像头接口后面玩视觉会有更大空间。纯做小批量低成本产品的人则会更偏爱 C3 这种价格压到极致的芯片。1.3 微雪这类开发板和外设生态微雪的 ESP32 开发板在国内外社区里都挺常见优点是板子做工规矩、引脚丝印清楚、资料页面里通常会给出引脚对照图和驱动链接。对于新手来说这并不是小打小闹的品牌溢价而是一个很重要的条件当你第一次插上 USB 线却发现电脑没反应时一个能查到串口芯片型号和BOOT 按键位置的官方资料页能帮你省下大量时间。另外选板子时还要注意两个不起眼的参数Flash 容量和 PSRAM。MicroPython 固件本身只占一两 MB但你的程序、上传的网页文件、模型文件都会占 FlashPSRAM 则决定了你能不能比较舒服地跑屏幕缓冲、摄像头帧缓存这些吃内存的东西。入门阶段 4MB Flash 够用但如果你已经打算玩屏幕或摄像头多花十几块选带 8MB Flash 甚至带 PSRAM 的版本后面会从容很多。2. 为什么是 MicroPython它解决了嵌入式入门最大的痛点2.1 REPL 交互式环境带来的即时反馈传统单片机开发是写代码 - 编译 - 烧录 - 看结果的循环一次循环少说几十秒多则几分钟而且任何一个环节出错都要重新来。MicroPython 则完全不同它把 Python 3 的语法搬到了单片机上启动后会提供一个 REPL 交互式控制台。你可以一行一行地敲代码按一下回车结果立刻出现在屏幕上。这个差异对新手来说是决定性的。初学阶段你要学习的是怎么让硬件乖乖听你的话而不是怎么和编译器搏斗。比如点亮一个 LED 这件事在 MicroPython 里就是from machine import Pin加一行Pin(2, Pin.OUT).value(1)不用理解长篇大论的头文件不用管编译链接过程敲完立即看到灯亮了。这种正向反馈会让你愿意继续往下试而不会被环境问题劝退。2.2 性能够不够看场景别被Python 很慢吓到我经常会听到一种质疑Python 跑在单片机上性能够吗这个问题得分场景。对于 GPIO 控制、传感器读取、OLED 显示、蓝牙/Wi-Fi 通信、MQTT 上报、JSON 解析这些常见物联网任务MicroPython 的性能完全够用因为瓶颈通常在网络延迟和传感器响应时间上而不是你那几十行 Python 代码。但如果你要做的是高精度电机闭环控制、音频实时处理、高速大量数据采集这类时间敏感型任务确实更适合用 C/C 甚至汇编去做。这并不矛盾。MicroPython 团队本身就没有打算把它包装成万能垂类替代品而嵌入式项目也经常是混合的C 写底层驱动MicroPython 写业务逻辑。你先把 MicroPython 玩明白再往 C 方向深入路径很清晰。我实操中很喜欢 MicroPython 的一点是代码量缩减。之前帮一个朋友把手上一段 Arduino 项目重写成 MicroPython业务逻辑部分从 600 多行 C 降到 150 行左右而且后续改需求的时候不用重新编译烧录直接在设备上改一行就能验证维护成本低了很多。2.3 学 MicroPython 不等于不学硬件知识有一点要提前说清楚免得后面走弯路MicroPython 帮你屏蔽的是代码编译和底层寄存器操作的复杂度但绝对不帮你屏蔽电路常识。你依然要理解什么是 GPIO、什么是上拉下拉、为什么要分压、LED 为什么要接限流电阻。这些是硬件的核心知识哪条路都绕不过去。不过反过来讲因为 MicroPython 的代码可读性极高你在学这些硬件概念时不必被繁琐的 API 术语干扰。比如Pin(4, Pin.IN, Pin.PULL_UP)这行代码几乎就是一句英语把引脚 4 设为输入并开启内部上拉。概念和代码一一对应学起来自然快。3. 硬件准备与环境三件套板子、串口驱动、供电3.1 你需要准备的最少清单先别急着囤传感器环境搭建阶段真正需要的只有这几样一块 ESP32 开发板微雪或同类的都行建议带排针版本一根 USB 数据线这一点极其重要下面单独说一台电脑Windows、macOS、Linux 都可以可选面包板、杜邦线、一个 LED 和 220Ω 电阻用于后面的点亮实验很多人的开发环境配置卡死在第一步不是板子坏了而是手里那根 USB 线只能充电、不能传数据。判断方法很简单把线插到手机上连接电脑看电脑有没有弹出 USB 调试选项或盘符或者直接看线上有没有Data字样。如果你手边只有充电线建议立刻换一根否则后面所有操作都是白费。3.2 USB 转串口芯片与驱动安装Windows 最常见的一个坑ESP32 开发板本身是没有 USB 协议的板上通常有一颗 USB 转串口芯片把电脑看到的 USB 口转成单片机认识 UART。微雪这块板子上常见的是 CP2102/CP2104 或 CH340、CH9102具体是哪个看板子丝印或商品详情页就能知道。Windows 系统下绝大多数情况需要手动安装驱动拿到板子先不要插电脑先通过丝印或详情页确认串口芯片型号。去芯片原厂或板卡厂商页面下载对应驱动。CP210x 系列装 Silicon Labs 的官方驱动CH340 装沁恒的驱动CH9102 装沁恒对应版本。插上 USB 线后打开设备管理器展开端口COM 和 LPT正常会看到COM3或COM5之类的端口号。如果显示黄色感叹号说明驱动不对卸载后重新安装并重启一次电脑。Linux 和 macOS 大多数情况是免驱的系统自带了 CP210x 和 ch341 的驱动。Linux 上插入后一般是/dev/ttyUSB0macOS 上是/dev/tty.usbserial-xxx。如果 Linux 下提示权限不足多半是当前用户不在 dialout 用户组里执行sudo usermod -aG dialout $USER后重新登录即可。3.3 供电与 USB 线的隐患一半的板子坏了其实是电的问题ES32 在开启 Wi-Fi 传输时瞬时电流可以冲到 300mA 甚至更高这对电脑 USB 口、尤其是笔记本 USB 口或劣质 Hub 来说是不小的负担。如果你发现板子在 Thonny 里明明连接正常一旦执行 Wi-Fi 连接代码就重启、或者一直打印乱码先怀疑供电而不是怀疑代码。入门阶段最稳妥的方式是用电脑 USB 口直连板子的 USB 口。如果要外接 5V 给板子供电请使用质量靠谱的电源适配器千万别把外部 5V 直接接到板子的 3.3V 引脚上那是烧芯片最快的方式。另外外接传感器或舵机时大电流设备不要从 3.3V 引脚取电老老实实从 5V 引脚取电、再单独接电源否则容易把板载 LDO低压差稳压器拖垮典型的症状就是电压跌落、系统随机重启。4. 烧录 MicroPython 固件一次讲清楚 esptool 全流程4.1 官方固件还是厂商固件先选官方的去 micropython.org/download 页面可以按芯片型号下载官方编译好的固件。官方固件的优势是干净、稳定、教程覆盖广微雪这类厂商有时也会放出内置了板载外设驱动比如屏幕、摄像头初始化配置的固件这类固件适合你目标明确地玩某一硬件但对入门来说官方通用固件更不容易出幺蛾子。固件文件名长这样ESP32_GENERIC-20240602-v1.23.0.bin前面的ESP32_GENERIC是板型代号中间是日期版本后面是固件版本。下载时注意选对芯片类型就行不要把 ESP32-S3 的固件烧到经典 ESP32 上。4.2 命令行烧录装 esptool、擦除、写入MicroPython 官方推荐用 esptool 烧录这是一个乐鑫官方的 Python 工具。你先确保电脑上已经安装了 Python 3然后打开终端执行python -m pip install esptool安装完成后用一根确认可以传数据的数据线把板子接到电脑。接着在终端里确认端口号Windows 在设备管理器里看Linux 执行ls /dev/ttyUSB*macOS 执行ls /dev/tty.usbserial*。烧录前先做一次全片擦除避免旧固件残留导致启动异常python -m esptool --port COM3 erase_flash擦除完成后写入 MicroPython 固件。以经典 ESP32 和官方通用固件为例python -m esptool --port COM3 --baud 460800 write_flash -z 0x1000 ESP32_GENERIC-20240602-v1.23.0.bin如果你用的是 Linux把COM3换成/dev/ttyUSB0macOS 换成/dev/tty.usbserial-xxx。这里有个非常容易踩的坑写入地址不能凭记忆写。不同芯片、不同固件封装方式偏移地址不一样。官方下载页和厂商页面通常都会把完整的烧录命令写出来直接复制即可。我自己常用的经验是经典 ESP32 的官方通用固件地址是 0x1000而 ESP32-S3、ESP32-C3 的合并固件在很多页面给的地址是 0x0。总之以固件下载页那行为准别背我的记忆当普适规律。4.3 进不去下载模式怎么办BOOT 键的正确用法很多时候 esptool 会提示A fatal error occurred: Failed to connect to ESP32: Timed out waiting for packet header十有八九是芯片没进入下载模式。虽然大多数开发板的自动下载电路可以自动复位但遇到线材质量不好或串口芯片兼容性问题时你得学会手动进入按住板子上的 BOOT 键不放。按住的同时按一下 RST/EN 键再松开这一步让芯片完成一次复位。松开 BOOT 键。此时芯片进入 bootloader 模式立刻重新运行烧录命令。烧录完成后按一下 RST 键复位板子就会从用户固件启动了。4.4 用 Thonny 自带烧录功能兜底如果你反复尝试命令行都搞不定还有一个图形化的兜底方案新版 Thonny 内置了固件烧录功能。打开 Thonny选择工具 - 选项 - 解释器在右下角找到安装或更新固件按钮选择设备端口和固件文件即可。这个方式对新手友好但日志信息不如命令行详细所以一旦提示失败我还是建议回到命令行走一遍至少能看到卡在哪一步。5. 配置开发环境Thonny 一窗搞定编辑、REPL 和文件上传5.1 Thonny 安装与解释器设置Thonny 是我给新手推荐的默认 IDE原因很直接编辑器、REPL 控制台、板子文件系统预览、脚本上传这四件套集成在一个窗口里完全不需要折腾第三方插件。去官网下载对应系统的安装包安装后打开做一次关键配置点击菜单栏工具 - 选项 - 解释器。选择解释器下拉框里选MicroPython (ESP32)。端口下拉框里选你前面确认好的 COM 口。点击确定。如果配置成功底部 Shell 窗口会出现类似这样的信息MicroPython v1.23.0 on 2024-06-02; ESP32 module with ESP32 Type help() for more information. 看到提示符就说明板子和电脑之间的链路已经通了。很多人在这一步卡住是因为端口下拉框是空的或选错这时候回到设备管理器确认端口号是否被其他程序占用再重新打开 Thonny。5.2 文件系统视图板子上的文件可以像 U 盘一样管理Thonny 左侧的文件视图分成两个区域一个是这台电脑的本地文件另一个是MicroPython 设备的板子文件系统。连接成功后你可以在板子区域看到boot.py和main.py这两个文件。boot.py是开机先执行的环境初始化脚本main.py是系统复位后紧接着执行的主程序。普通入门期boot.py保持默认不动你要写的业务代码全放在main.py里。把脚本传到板子上非常简单在本地编辑器中写好代码后选择文件 - 另存为在弹窗里选择MicroPython 设备文件名填main.py。也可以直接在文件视图里用鼠标把本地.py文件拖到设备区域。5.3 进阶备选VS Code mpremote 命令行方案如果你平时写代码已经重度依赖 VS Code不想为一颗单片机单独学一个新编辑器那可以考虑 mpremote。它是 MicroPython 官方维护的命令行工具配合 VS Code 的 MicroPico 插件体验可以做到接近 Thonnypython -m pip install mpremote mpremote connect COM3 # 进入 REPL mpremote run main.py # 把本地文件在板子上执行 mpremote fs cp main.py :main.py # 把文件上传到板子这条路线适合已经熟悉命令行的人但纯新手我还是建议先用 Thonny。原因在于 mpremote 的上传、执行、文件管理都是独立命令对概念的掌握要求更高而 Thonny 把所有操作都做成了可视化的一个动作。6. 第一个程序与断电运行从 REPL 到 main.py 自动启动6.1 交互式小实验先让板子说句话开发环境配好之后先别急着写正式程序直接在 Shell 里敲几行命令感受一下 REPL print(hello esp32) hello esp32 import sys sys.platform esp32看到输出就说明 MicroPython 解释器在正常工作。接下来试试点亮 LED。不同开发板的板载 LED 引脚不一样经典 ESP32 上很多板子用 GPIO2而 S3 系列可能是 GPIO48 或者其他引脚。代码里我留一个变量请根据你板子的原理图自行修改from machine import Pin, Timer LED_PIN 2 # 改成你板子上的实际引脚 led Pin(LED_PIN, Pin.OUT) led.value(1)敲完这一句如果灯亮了恭喜你整个 MicroPython 开发链路已经完全打通。6.2 编写 LED 闪烁程序并保存为 main.py现在我们把灯变成闪烁效果。在 Thonny 编辑器里新建一个文件写入from machine import Pin import time LED_PIN 2 # 按板子原理图修改 led Pin(LED_PIN, Pin.OUT) while True: led.value(not led.value()) time.sleep_ms(500)保存到 MicroPython 设备时文件名填main.py。然后点击工具栏上的运行按钮或者按 CtrlD 让板子执行软复位。复位后程序会自动启动如果你看到 LED 以 1Hz 的频率闪烁说明main.py已经被正确装载并执行了。有些板子的 LED 是低电平点亮也就是 GPIO 输出0时灯亮、输出1时灯灭。上面的代码用not led.value()做翻转无论高电平还是低电平点亮都能看到闪烁只是初始点亮相位不同不用纠结。6.3 断电运行microPython 设备的启动机制热词里经常看到esp32 micropython 断电运行这其实是 MicroPython 最基础也最实用的特性板子断电再上电后会自动依次执行boot.py和main.py。你可以做一个小实验把上面的代码保存为main.py后拔掉 USB 线等几秒再插回去会发现 LED 直接开始闪烁不需要你重新运行任何程序。这个机制意味着你可以把板子接上一个独立电源丢在角落里跑自己的逻辑让它做一个真正的无人值守设备。如果上电后发现没有自动运行优先检查这几件事main.py是否真的保存在设备根目录而不是保存在本地电脑路径。文件有没有名字拼写错误MicroPython 只认小写main.py。main.py里有没有语法错误或运行期异常。Thonny 的 Shell 窗口会显示 Traceback 输出哪怕板子已经断电重启过一次你也可以通过停止/重启按钮重新挂接板子再按 RST 键查看启动日志。6.4 下一步外部中断和真正的物联网项目这一篇做到 LED 闪烁你的 MicroPython 环境就算正式落地了。但我特别提醒你不要停在闪烁这一步。往后值得优先玩的是外部中断传感器触发、按键检测、低功耗唤醒全靠它。外部中断的思路是用事件回调代替轮询比如Pin(0, Pin.IN, Pin.PULL_UP).irq(triggerPin.IRQ_FALLING, handlercallback)事件来了自动执行callbackCPU 不需要一直空转。这个主题很适合作为系列第 02 篇后面的传感器采集、Wi-Fi 配网、MQTT 上报也会和它连在一起。7. 新手上路避坑清单串口、电源、固件三类高频问题7.1 串口连接不上先从系统和占用查起如果你在 Thonny 里看不到任何串口选项或者连接时提示失败按顺序排查设备管理器里有没有看到 COM 口。没有查驱动、换 USB 口、换数据线。设备管理器的 COM 口图标有黄色感叹号。卸载驱动重装。COM 口是存在的但 Thonny 连接失败。回想一下你刚才是否开着串口调试助手、浏览器 Web Serial 或者其他 IDE 的监视器串口是独占设备同一时间只能有一个程序占用。如果以上都没问题按一下板子上的 RST 键看 Thonny Shell 窗口有没有打印启动信息有时候只是连接超时需要手动复位一下。7.2 烧录失败按键、地址、波特率三连查esptool 报Timed out waiting for packet header是最常见的烧录失败。我的排错顺序固定是先按住 BOOT 插入/复位确认进入下载模式再确认写入地址和蜡件下载页的命令一致最后把波特率降到 115200 试试。注意高波特率 460800 对线材要求更高劣质线在高波特率下会频繁超时降速往往就好了。如果擦除 flash 都失败并且换了线、换了 USB 口、手动下载模式都无效可以观察板子上的电源指示灯是否稳定。供电不稳定时芯片根本跑不稳谈何串口通信。7.3 上电后疯狂重启、发热异常这类问题在入门阶段常被误判为固件写坏了。实际上纯固件问题一般不会导致板子发热。如果板子摸上去明显发烫先断电检查有没有把 5V 接到 3.3V、有没有把排母插反、有没有让传感器或舵机从 3.3V 引脚取大电流。如果不是接线问题再看是不是程序在启动早期就循环异常比如main.py里某个模块反复导入失败导致每秒钟都在软复位。这时按住 BOOT 键重新连接电脑把设备里的main.py改名或删掉再上电观察。7.4 购买装备时的防坑建议最后聊一点购买经验能帮你省下后面几天的时间新手不要买那种裸芯片模块除非你已经会用外接 USB-TTL 烧录器。买板子时优先选板载 USB 转串口芯片的型号插 USB 就能用是最省心的形态。认准串口芯片驱动好找的型号。CP2102、CH340 的资料满天飞通用性最好。优先选丝印清楚、有官方引脚图的板子。微雪这类厂商会把引脚定义、驱动链接、示例固件放在产品页或资料库排查问题时很方便。可以稍微为板载调试器多花一点钱。有些 ESP32-S3 开发板自带了 USB-JTAG 调试器烧录和串口监视都更稳对入门和后续调试都有帮助。环境配置这件事80% 的失败都集中在 USB 线、串口驱动、下载模式这三个环节。我第一次带人入坑的时候前后帮三个人排查过板子坏了最后无一例外都是充电线或驱动问题。所以真遇到问题时别急着怀疑硬件照着清单一步步来你会发现自己离跑通第一个程序其实只差一根数据线的距离。