# ESP32开发环境搭建—Windows系统

> [!TIP] 🚀 初次接触！在 Windows 系统中搭建 ESP32 开发环境
> - 💡 **碎碎念**😎：本文将引导你在 Windows 系统下安装 ESP-IDF 开发环境，并推荐使用 VS Code 插件进行简便安装。  
> - 📺 **视频教程**：[点击观看](https://www.bilibili.com/video/BV14o62YQEBC)  
## 一、使用VS Code插件直接安装

### 1.1 下载插件

在Windows系统下使用VS Code插件直接安装ESP-IDF可以参考官方文档：[Install ESP-IDF and Tools](https://docs.espressif.com/projects/vscode-esp-idf-extension/zh_CN/latest/installation.html)，下面介绍安装过程：

安装VS Code，并安装ESP-IDF插件

![](attachments/20241230173816.png)

### 1.2 配置插件：安装ESP-IDF

按Ctrl+Shift+P打开命令行，输入`Configure ESP-IDF Extension`

![](attachments/20241230174252.png)

选择`ESP-IDF： Configure ESP-IDF Extension`这一项来配置插件，选择后页面如下图所示：

![](attachments/20241230174358.png)

这里我们选择Express快速安装。

![](attachments/20241230180528.png)

第一项为下载服务器选项，推荐使用 Espressif 下载服务器。
第二项为ESP-IDF版本，建议选择V开头的正式发布板，本教程使用V5.2.3版本。
第三项ESP-IDF源码位置，请选择不带空格的路径，且对应文件夹需要为空。
第四项ESP-IDF 工具 位置，要求同上，**但不能与第三项相同**！
这里我们选择在D盘根目录下新建`Espressif`文件夹。

然后点击安装即可，如下图所示：

![](attachments/20241230175629.png)

等待十几分钟即可安装完成（网络差可能会久一点），安装完成后如下图所示：

![](attachments/20241230184622.png)

至此开发环境安装完成，我们可以打开一个示例工程编译，验证安装是否完成。

### 1.3 测试开发环境可用

点击shown examples 选择刚才下载的IDF版本

![](attachments/20241230185003.png)


随便选择一个示例工程，这里以blink工程为例：

![](attachments/20241230184954.png)


点击新建示例项目，选择一个存储位置：

![](attachments/20241230185234.png)

VS Code会自动打开项目目录，如下：

![](attachments/20241230185528.png)

点击扳手图标构建项目：

![](attachments/20241230185634.png)

编译停止后，命令行显示下列内容，则开发环境安装无误。至此ESP32的开发环境就准备完毕了。

![](attachments/20241230190036.png)

至于进一步烧录代码至开发板，将在下一节介绍。

## 二、 手动安装

Windows系统下手动安装可以参考官方文档：[Windows 平台工具链的标准设置](https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/get-started/windows-setup.html#),下面简单介绍安装过程：

### 2.1 下载 ESP-IDF 工具安装器

打开下面的链接，下载 ESP-IDF 工具安装器

>https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/get-started/windows-setup.html

![](attachments/20241230181401.png)

选择自己需要的版本，这里以V5.2.3版本为例（后续教程也使用该版本）

![](attachments/20241230181701.png)

### 2.2 安装ESP-IDF

下载完成后打开esp-idf-tools-setup-offline-x.x.x.exe程序即可开始安装

![](attachments/20241230195856.png)

选择安装路径：

![](attachments/20241230195935.png)

选择需要的组件和驱动程序（建议全选）：

![](attachments/20241230200003.png)

等待安装完成即可，安装完成如下图：

![](attachments/20241230200620.png)


### 2.3 测试开发环境可用
下面编译一个示例工程，以确保ESP-IDF可以正常工作，示例代码位于`安装目录\frameworks\esp-idf-v5.2.3\examples`,如下图:

![](attachments/20241230201034.png)

复制`examples/get-started`下的`blink`点灯工程到桌面（或其他位置），在安装完成后弹出的命令行中切换到`blink`目录，并运行`idf.py build`命令：

![](attachments/20241230201518.png)

运行后编译完成输出如下，则开发环境安装无误，至此ESP32的开发环境就准备完毕了。

![](attachments/20241230202342.png)
### 2.4 配置VS Code插件

**但如果要使用VS Code插件功能，还需要继续下面的步骤（可选，不使用插件进行开发也完全没有问题）：**

依然是安装VS Code，并安装ESP-IDF插件

![](attachments/20241230173816.png)

按Ctrl+Shift+P打开命令行，输入`Configure ESP-IDF Extension`

![](attachments/20241230174252.png)

选择`ESP-IDF： Configure ESP-IDF Extension`这一项来配置插件，选择后页面如下图所示：

![](attachments/20241230174358.png)

这里我们选择第三个选项，使用现有设置，设置`Enter ESP-IDF directory (IDF_PATH)`为安装根目录下的`frameworks\esp-idf-v5.2.3`目录，设置`Enter ESP-IDF Tools directory (IDF_TOOLS_PATH)`为安装根目录，如下图（本教程中安装根目录为`c:\Espressif\V523`）

![](attachments/20241230203618.png)

点击安装，等待十几分钟安装完成即可，要注意的是虽然是离线安装，但这个步骤依赖网络下载python环境相关的工具，容易失败（失败很大可能是网络引起的，不妨换个网络环境重新尝试😂）

![](attachments/20241230203707.png)


安装成功显示如下：

![](attachments/20241230204358.png)


## 参考链接

1. https://www.bilibili.com/video/BV1J14y1n7Ve/?spm_id_from=333.337.search-card.all.click&vd_source=ef5a0ab0106372751602034cdd9ab98e
2. https://blog.csdn.net/ZRongZH/article/details/129237476
3. https://www.bilibili.com/video/BV1Mv4y1U7x9/?spm_id_from=333.999.0.0&vd_source=ef5a0ab0106372751602034cdd9ab98e