使用一键安装工具快速搭建 ESP-IDF 开发环境 (Windows)

news2025/2/13 2:11:35

我们收到用户对 ESP-IDF SDK 软件开发环境感到搭建难、门槛高的反馈。为解决用户在此方面的问题。为此，我们推出本期教程介绍在 Windows 操作系统下使用一键安装工具快速搭建 ESP-IDF 开发环境。

您可以观看下面的教程视频，也可以阅读接下来本篇的图文教程。

【乐鑫教程】｜使用一键安装工具快速搭建 ESP-IDF 开发环境 (Windows)

本篇教程分为以下三个部分：

Part 1：使用一键安装工具快速搭建 ESP-IDF SDK 软件编译环境——Windows

1. 下载 ESP-IDF 工具安装器

2. 安装 ESP-IDF 软件编译环境

3. 同一 Windows 环境下同时运行多个版本的 SDK 软件编译环境

Part 2：使用 ESP-IDF CMD 命令行终端编译 SDK 例程——ESP-loT-Bridge

Part 3：使用 VS Code 编写 SDK 代码或进行二次开发

提示：推荐使用系统：64 bit Windows 10 及以上。

在进行开发环境搭建时请暂时关闭电脑端杀毒软件避免误删文件。

Part 1：使用一键安装工具快速搭建 ESP-IDF SDK 软件编译环境——Windows

1. 下载 ESP-IDF 工具安装器

首先我们需要访问乐鑫官网，在支持——技术文档中搜索“编程指南”，找到“ESP-IDF 编程指南”。ESP-IDF 编程指南中的快速入门章节是对快速搭建 ESP-IDF 开发环境的介绍，在这里我们可以找到 ESP-IDF 的安装说明 “Windows Installer”。

在跳转后的页面找到 ESP-IDF 工具安装器，并点击下载链接进行下载。

您也可以直接点击此链接下载 ESP-IDF 工具安装器：ESP-IDF 工具安装器。

跳转成功后可以看到 ESP-IDF 的在线版本和离线版本安装包。

对于选择何种版本的安装包，我们有如下建议：

如使用 Release 版本或 Master 版本的 ESP-IDF SDK 软件开发环境，需要使用在线安装包。
使用在线安装包安装时，建议电脑连接有线网络加快网速。
国内用户如访问 Github 有困难，建议勾选 Gitee 镜像。

如需使用 Tag 版本的 ESP-IDF SDK 软件开发环境，建议使用离线安装包。
离线安装程序不需要任何网络连接，且安装程序中包含了 Python、Git、交叉编译器、CMake 和 Ninja 构建工具等所有需要的依赖文件，这些都是 ESP-IDF 中构建固件的必备工具，因此我们更推荐刚入门的用户使用离线安装程序。

ESP-IDF SDK 软件环境适配所有乐鑫 ESP32 系列的产品，但不同系列的 ESP32 产品要求的 ESP-IDF SDK 版本不同，具体对应的版本可以在官网的 ESP-IDF SDK 软件发布说明中查看。

此处需要注意：

如果需要使用 ESP32-C6 或 ESP32-H2 系列产品，目前需要在选择 ESP-IDF 版本中选择 Master 版本的 SDK。
如无特殊需求，我们推荐使用最新 Tag 或 Release 版本的 SDK。

此外，ESP-IDF 的开发工作流程和不同版本的具体区别，可以访问链接查看：ESP-IDF 版本简介 - ESP32 - — ESP-IDF 编程指南 latest 文档

本教程中选用的是离线版本安装包演示安装 ESP-IDF Tag v5.0 版本的软件编译环境。

2. 安装 ESP-IDF 软件编译环境

首先，点击运行安装包并选择语言环境。

勾选同意此协议，进入下一步。

等待系统检查完成，继续下一步。

选择 ESP-IDF 编译工具安装的路径，再点击下一步。

在配置界面中，可以为 ESP 系列的产品选择安装串口驱动和 USB 驱动，还可以勾选需要的产品系列。设置完成后，进入下一步。

检查安装路径，点击安装完成。此处大约需要等待 4 分钟。

安装完成后，桌面上生成了 ESP-IDF CMD 终端，打开终端，当终端成功打印了“idf.py build”指令时，说明我们的环境已经安装成功了。

3. 同一 Windows 环境下同时运行多个版本的 SDK 软件编译环境

我们注意到大家会对“同一 Windows 环境下是否支持多个版本的 SDK 软件编译环境”存在疑惑。事实上，多个版本的 SDK 可以在同一 Windows 环境下同时存在。

我们运行“idf.py build”指令在两个不同环境的终端内进行代码编译，可以看到当我们使用不同版本的 SDK CMD 终端编译环境编译例程时，可以各自独立编译成功，不受任何限制，不会相互干扰。编译完成后会打印日志，日志中显示当前编译工程生成的固件以及对应固件的下载地址，并提示我们使用“idf.py -p (PORT) flash”指令来烧录固件。