在 VSCode 上以 ESP32-S3 板子为例调试 MicroPython

首先下载准备好 ESP32-S3 的固件：https://micropython.org/download/ESP32_GENERIC_S3/，一定要下载 .bin 文件，固件内集成了 MicroPython ，无需额外安装。

官方给的原始 .bin 固件分区表默认可扩展容量只有 2M，如果你的 ESP32 板子的 flash 容量上限有 16M，是可以将这部分可扩展容量扩容至 14M 的，这里以 ESP32_GENERIC_S3-20260824-v1.29.0.bin 这个固件为例，具体的命令行操作如下：

pip install mp-image-tool-esp32
mp-image-tool-esp32 ./ESP32_GENERIC_S3-20260824-v1.29.0.bin -f 16M --add vfs:fat:14M

命令执行完成后会在当前目录下生成一个新的 .bin 固件，准备好用于后续步骤的烧写。

 

VSCode 上搜索并安装插件 MicroPython Starter Kit

安装完成后，进入插件控制面板，先点击 重新安装/修复工具

修复完成后，将 ESP32-S3 板子用 USB 连接电脑

通常电脑会自动识别 USB 设备，并且设备管理器会多出 COM3 串口：

回到 VSCode 的插件控制面板，点击 选择/刷新串口 

VSCode 会弹出选择串口的选项，选择 COM3 即可，更新串口成功状态栏会提示“串口已更新为 COM3”：

这样就实现了 VSCode 与 ESP32-S3 板子建立连接，下一步可以对板子进行固件烧录操作了：首先在插件控制面板上点击 全片擦除，将板子擦除干净，不要有脏数据残留：

擦除很重要，擦除成功的命令行输出状态如下：

然后再点击 烧录自定义固件 或者 烧录默认固件，由于当前插件官方自带的默认固件不符合你的板子型号，这里选择烧录自定义固件：

找到文档最开始你已经准备好的 .bin 固件，并选中进行烧录：

烧录完成并成功的状态如下：

固件烧录完成后，下一步就是要将自定义的 Python 代码上传到板子上：

VSCode UI 左上部是本地文件目录结构，这里以上传 boot.py 为例，选中它右键，点击 上传文件 

命令行输出如上并右下角弹出“文件上传成功：”字样代表上传完毕，如下图，左下部设备文件栏会多出一个 boot.py 文件

重复上述步骤，将本地想要上传的所有 Python 脚本均上传至板子，在设备文件栏，选中 main.py 文件，可以 运行设备文件 或 删除设备文件

目前当前的插件仅支持上传 .py 后缀的脚本，并且上传文件不会像刷固件那样必须先擦除，直接覆盖是可以的。上传完毕后，点击 运行设备文件 可以测试该上传脚本在板子环境下运行效果。

 

注：非 .py 文件上传至板子如果右键“上传文件”，则提示格式无法上传，则可通过在界面上左上角文件拖拽到左下角的方式实现强行上传，如此操作对尺寸不超过60k的文件有效。若文件尺寸超过60K，这里以 example.wav 这个音频文件为例，则会报错上传失败，此时则可关闭 REPL 终端并使用如下命令进行上传：

pip install mpremote
mpremote connect COM3 fs cp example.wav :example.wav

操作成功则会在终端出现一个进度条：

 

待进度条至100%则上传成功。

 

最终整体 VSCode UI 效果为：左上本地文件目录、左下板子内文件目录、中上代码、中下终端、右侧copilot，集烧写、目录浏览、代码编辑、调试、命令控制、AI助手于一身，完美组合！完美替代 thonny 等其它不够易用的 IDE