Skip to content

Windows 环境搭建

这一章不是为了炫工具,而是为了打通“电脑里的代码”到“手上那块板子真的动起来”的通道。

环境搭建的目标只有一个:你能在 Windows 终端里执行 idf.py build,并把程序烧录到 ESP32 开发板。先不要急着理解所有工具,先知道它们的分工。

工具链分工

ESP-IDF 是乐鑫官方 IoT 开发框架,里面包含构建系统、驱动、网络协议栈、示例工程和文档。Windows 上通常使用 ESP-IDF Tools Installer,它会帮你安装 Python、Git、编译器、OpenOCD 等工具。

开发板通过 USB 连接电脑后,会出现一个串口。烧录是把固件写入 Flash,监视是从串口读取日志。很多问题其实不是代码错,而是串口号、驱动、数据线或目标芯片选错了。

安装步骤

  1. 打开乐鑫官方 ESP-IDF Windows 安装说明。
  2. 使用 ESP-IDF Tools Installer 安装推荐版本。
  3. 安装完成后,打开 “ESP-IDF PowerShell” 或 “ESP-IDF Command Prompt”。
  4. 执行 idf.py --version,确认命令可用。
  5. 用 USB 数据线连接 ESP32 开发板,在设备管理器中确认串口号。

如果你看到 idf.py 无法识别,通常是没有打开 ESP-IDF 专用终端,或环境变量没有加载。先从开始菜单打开安装器创建的终端,而不是普通 PowerShell。

powershell
idf.py --version
python --version
git --version

连接开发板

以常见 DevKit 开发板为例,连接方式通常是 USB 数据线直连开发板。注意“能充电”的线不一定能传数据。如果烧录时一直连接失败,优先换数据线、换 USB 口,再检查 BOOT/RESET 按键。

第一次烧录建议先降低复杂度:只连接开发板,不外接面包板和传感器,避免外部电路影响启动模式。

官方资料

本章提示词

我正在 Windows 上安装 ESP-IDF 并连接 ESP32 开发板。请根据我贴出的终端输出、设备管理器串口信息和烧录日志,判断环境是否正确,并按优先级给出排查步骤和下一步最小验证命令。

本教程使用中文编写,代码和命令保留必要英文。