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

这篇具有很好参考价值的文章主要介绍了使用一键安装工具快速搭建 ESP-IDF 开发环境 (Windows)。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

我们收到用户对 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 开发环境 (Windows)

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

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

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

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

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

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

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

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

如需使用 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 开发环境 (Windows)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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