mirror of
https://github.com/DuRuofu/ESP32-Guide.git
synced 2026-02-05 14:40:35 +08:00
160 lines
5.6 KiB
Markdown
160 lines
5.6 KiB
Markdown
# 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插件
|
||
|
||
|
||
|
||
### 1.2 配置插件：安装ESP-IDF
|
||
|
||
按Ctrl+Shift+P打开命令行，输入`Configure ESP-IDF Extension`
|
||
|
||
|
||
|
||
选择`ESP-IDF： Configure ESP-IDF Extension`这一项来配置插件，选择后页面如下图所示：
|
||
|
||
|
||
|
||
这里我们选择Express快速安装。
|
||
|
||
|
||
|
||
第一项为下载服务器选项，推荐使用 Espressif 下载服务器。
|
||
第二项为ESP-IDF版本，建议选择V开头的正式发布板，本教程使用V5.2.3版本。
|
||
第三项ESP-IDF源码位置，请选择不带空格的路径，且对应文件夹需要为空。
|
||
第四项ESP-IDF 工具 位置，要求同上，**但不能与第三项相同**！
|
||
这里我们选择在D盘根目录下新建`Espressif`文件夹。
|
||
|
||
然后点击安装即可，如下图所示：
|
||
|
||
|
||
|
||
等待十几分钟即可安装完成（网络差可能会久一点），安装完成后如下图所示：
|
||
|
||
|
||
|
||
至此开发环境安装完成，我们可以打开一个示例工程编译，验证安装是否完成。
|
||
|
||
### 1.3 测试开发环境可用
|
||
|
||
点击shown examples 选择刚才下载的IDF版本
|
||
|
||
|
||
|
||
|
||
随便选择一个示例工程，这里以blink工程为例：
|
||
|
||
|
||
|
||
|
||
点击新建示例项目，选择一个存储位置：
|
||
|
||
|
||
|
||
VS Code会自动打开项目目录，如下：
|
||
|
||
|
||
|
||
点击扳手图标构建项目：
|
||
|
||
|
||
|
||
编译停止后，命令行显示下列内容，则开发环境安装无误。至此ESP32的开发环境就准备完毕了。
|
||
|
||
|
||
|
||
至于进一步烧录代码至开发板，将在下一节介绍。
|
||
|
||
## 二、 手动安装
|
||
|
||
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
|
||
|
||
|
||
|
||
选择自己需要的版本，这里以V5.2.3版本为例（后续教程也使用该版本）
|
||
|
||
|
||
|
||
### 2.2 安装ESP-IDF
|
||
|
||
下载完成后打开esp-idf-tools-setup-offline-x.x.x.exe程序即可开始安装
|
||
|
||
|
||
|
||
选择安装路径：
|
||
|
||
|
||
|
||
选择需要的组件和驱动程序（建议全选）：
|
||
|
||
|
||
|
||
等待安装完成即可，安装完成如下图：
|
||
|
||
|
||
|
||
|
||
### 2.3 测试开发环境可用
|
||
下面编译一个示例工程，以确保ESP-IDF可以正常工作，示例代码位于`安装目录\frameworks\esp-idf-v5.2.3\examples`,如下图:
|
||
|
||
|
||
|
||
复制`examples/get-started`下的`blink`点灯工程到桌面（或其他位置），在安装完成后弹出的命令行中切换到`blink`目录，并运行`idf.py build`命令：
|
||
|
||
|
||
|
||
运行后编译完成输出如下，则开发环境安装无误，至此ESP32的开发环境就准备完毕了。
|
||
|
||
|
||
### 2.4 配置VS Code插件
|
||
|
||
**但如果要使用VS Code插件功能，还需要继续下面的步骤（可选，不使用插件进行开发也完全没有问题）：**
|
||
|
||
依然是安装VS Code，并安装ESP-IDF插件
|
||
|
||
|
||
|
||
按Ctrl+Shift+P打开命令行，输入`Configure ESP-IDF Extension`
|
||
|
||
|
||
|
||
选择`ESP-IDF： Configure ESP-IDF Extension`这一项来配置插件，选择后页面如下图所示：
|
||
|
||
|
||
|
||
这里我们选择第三个选项，使用现有设置，设置`Enter ESP-IDF directory (IDF_PATH)`为安装根目录下的`frameworks\esp-idf-v5.2.3`目录，设置`Enter ESP-IDF Tools directory (IDF_TOOLS_PATH)`为安装根目录，如下图（本教程中安装根目录为`c:\Espressif\V523`）
|
||
|
||
|
||
|
||
点击安装，等待十几分钟安装完成即可，要注意的是虽然是离线安装，但这个步骤依赖网络下载python环境相关的工具，容易失败（失败很大可能是网络引起的，不妨换个网络环境重新尝试😂）
|
||
|
||
|
||
|
||
|
||
安装成功显示如下：
|
||
|
||
|
||
|
||
|
||
## 参考链接
|
||
|
||
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
|
||
|
||
|