ESP-IDF 常用命令速查表

更新：2025-06-25
关键词：ESP-IDF、idf.py、ESP32、命令行、一键速查

---

一、写在前面

ESP-IDF（Espressif IoT Development Framework）是乐鑫官方推出的 ESP32 全系列芯片 开发框架。
日常开发中，我们 90 % 的操作都可以通过一条 idf.py 命令完成。
本文把高频命令按「工作流」整理成 “速查表”，收藏即可秒用，无需再翻官方文档。

---

二、环境前提

1. 已完成 ESP-IDF 安装（带 idf.py 可执行）
2. 已连接 USB 转串口驱动（CH343/CP2102/FT232 等）
3. 终端支持 Bash/PowerShell/CMD（Windows 推荐 ESP-IDF PowerShell）

---

三、速查表（按开发流程）

阶段	命令	说明	示例
0. 创建	idf.py create-project my_proj	一键生成模板工程	生成 my_proj/ 目录
1. 选型	idf.py set-target esp32s3	切换目标芯片	esp32 / esp32s2 / esp32c3 / esp32s3
2. 配置	idf.py menuconfig	图形化配置	改串口波特率、分区表、Wi-Fi 国家码
3. 编译	idf.py build	全量编译	首次编译约 1~3 min
4. 烧录	idf.py -p COM3 flash	烧录固件	COM3 可换 /dev/ttyUSB0
5. 监视	idf.py -p COM3 monitor	实时日志	按 Ctrl+] 退出
6. 一键完成	idf.py -p COM3 flash monitor	烧完自动看日志	最常用组合！

---

四、高频辅助命令

场景	命令	备注
查看芯片支持列表	idf.py list-targets	确认当前 IDF 版本支持哪些芯片
查看当前目标	idf.py get-target	防止忘切目标导致编译错误
清理构建缓存	idf.py fullclean	解决“玄学”编译失败
仅擦除 Flash	idf.py erase-flash	恢复出厂，慎用
查看固件大小	idf.py size	快速判断是否超 OTA 分区
查看组件大小	idf.py size-components	找出体积大户
保存默认配置	idf.py save-defconfig	生成 sdkconfig.defaults 方便 CI

---

五、典型完整流程（复制即用）

# 1. 新建工程
idf.py create-project hello_world
cd hello_world

# 2. 选择芯片
idf.py set-target esp32s3

# 3. 图形化配置（可选）
idf.py menuconfig

# 4. 编译
idf.py build

# 5. 烧录 + 日志
idf.py -p COM3 flash monitor

---

六、Windows 用户小贴士

问题	解决方案
找不到 COM 口	设备管理器 → 端口 → 记录编号，如 COM3
权限拒绝	右键 ESP-IDF PowerShell → 以管理员身份运行
中文乱码	终端输入 chcp 65001 切换 UTF-8

---

七、Linux/Mac 用户小贴士

问题	解决方案
串口权限不足	把自己加入 dialout 组： sudo usermod -a -G dialout $USER 然后注销重登
多串口分不清	ls -l /dev/serial/by-id/ 看芯片 ID

---

八、速记口诀（背下来）

“设目标 → 配菜单 → 编 → 烧 → 看”
一条组合：idf.py -p COM3 flash monitor

---

九、官方文档入口

• 英文在线：https://docs.espressif.com/projects/esp-idf
• 中文在线：https://docs.espressif.com/projects/esp-idf/zh_CN/latest
• 命令行全集：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/api-guides/build-system.html#idf-py

---

十、评论区互动

你还想补充哪些命令？	留言告诉我，持续更新！
踩过哪些坑？	分享出来，互帮互助～

---

如果本文帮到你，记得 收藏 + 点赞 + 关注 三连，后续更新 ESP-IDF 调试技巧 和 VSCode 一键编译配置！