---
type: concept
title: ESP32 固件烧录
created: 2026-06-19
updated: 2026-06-19
tags: [esp32, firmware, flashing, hardware, embedded]
---

## 定义
固件烧录（Firmware Flashing）是将编译后的二进制程序（通常 `.bin` 文件）写入嵌入式设备闪存（Flash）的过程。对于 ESP32 系列，常见烧录方式分为 **UART 串口烧录** 和 **USB 直接烧录** 两大类。

## 核心要点

### 烧录方式
| 方式 | 优点 | 缺点 |
|------|------|------|
| **UART 串口烧录** | 兼容性好（CH340/CH343/CP210x 都支持）、稳定 | 需外接 USB 串口桥、占一个串口 |
| **USB 直连烧录**（ESP32-S3 内置 USB-JTAG） | 无需串口桥、一根线搞定 | 部分老版芯片不支持 |

### 关键参数
- **烧录地址（Flash Address）**：`0x0`（小智AI固件已合并为 `merged-binary.bin`）
- **SPI 速度/模式**：默认（不要选 QOUT/DOUT）
- **BAUD 波特率**：可选高值（如 921600）以加速
- **COM 端口**：在设备管理器查看，CH34x 或 CP210x 字样

### 工具分类
- **桌面端**：[Flash Download Tool 3.9.7](https://www.espressif.com.cn/zh-hans/support/download/other-tools)（乐鑫官方，Windows）
- **Web 端**：[ESP-Launchpad](https://espressif.github.io/esp-launchpad/)（乐鑫官方，浏览器 Web Serial）
- **命令行**：`esptool.py`（Python 跨平台 CLI）
- **IDE 集成**：Arduino IDE、PlatformIO、ESP-IDF

### ESP-IDF 命令族（来源 [[wiki/library/Windows搭建 ESP IDF 5.3开发环境|小智 AI 教程]]）
| 命令 | 作用 |
|------|------|
| `idf.py build` | 仅编译 |
| `idf.py flash` | 烧录 |
| `idf.py monitor` | 串口监视 |
| `idf.py build flash monitor` | 编译+烧录+监视 一气呵成 |
| `idf.py -b 2000000 build flash monitor` | 提高波特率加速 |
| `idf.py build app-flash monitor` | 仅烧录 app 分区 |
| `idf.py set-target esp32s3` | 切换目标芯片 |
| `idf.py -p COM5 ...` | 指定串口 |

### 常见坑
1. **路径含中文** → 烧录工具无法加载 bin 文件 + ESP-IDF 编译失败
2. **未勾选 bin 文件** → START 后无反应
3. **COM 端口选错** → 设备连接失败
4. **未安装串口驱动** → 设备管理器看不到端口
5. **烧录后未重启** → 程序未启动
6. **迁移工程路径后未删 build/** → ESP-IDF 编译失败（绝对路径残留）
7. **编译时开着杀毒软件** → 编译慢如蜗牛甚至失败（实时扫描 .o 中间文件）
8. **波特率设过高** → 2M 稳定，更高值易失败

## 不同来源的说法
| 来源 | 观点 |
|------|------|
| [[wiki/library/Flash工具Web端烧录固件（无IDF开发环境）.md\|Flash 烧录教程]] | 强调三种免 IDF 烧录方式（桌面/Web/第三方），固件已合并 bin |
| [[wiki/library/Windows搭建 ESP IDF 5.3开发环境\|ESP-IDF 5.3 教程]] | 强调 `idf.py` 命令族完整工作流，路径无中文 + 关杀毒软件 + 删 build 三大实践 |

## 相关实体
- [[wiki/entities/espressif|Espressif 乐鑫]]
- [[wiki/entities/esp-idf|ESP-IDF 开发框架]]
- [[wiki/entities/esp32-s3|ESP32-S3 开发板]]
- [[wiki/entities/flash-download-tool|Flash Download Tool]]
- [[wiki/entities/esp-launchpad|ESP-Launchpad]]
- [[wiki/entities/xiaozhi-ai-terminal|小智AI终端]]

## 参考来源
- [[wiki/library/Flash工具Web端烧录固件（无IDF开发环境）.md|Flash 烧录教程]]
- [[wiki/library/Windows搭建 ESP IDF 5.3开发环境|ESP-IDF 5.3 Windows 搭建教程]]