Skip to content

ESP32开发环境搭建—Windows系统

🚀 初次接触!在 Windows 系统中搭建 ESP32 开发环境

  • 💡 碎碎念😎:本文将引导你在 Windows 系统下安装 ESP-IDF 开发环境,并推荐使用 VS Code 插件进行简便安装。
  • 📺 视频教程点击观看

一、使用VS Code插件直接安装

1.1 下载插件

在Windows系统下使用VS Code插件直接安装ESP-IDF可以参考官方文档:Install ESP-IDF and Tools,下面介绍安装过程:

安装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 平台工具链的标准设置,下面简单介绍安装过程:

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