ESP32开发应用 ——VScode搭建开发环境

---

前言

ESP32 可以在 Windows、Linux 以及 macOS 系统下进行应用开发，本文主要讲述在 Windows 操作系统下，通过 VSCode 搭建 ESP32 开发环境的过程。

---

1、获取 ESP-IDF

1.1 下载 ESP-IDF 工具安装器

ESP-IDF 是乐鑫官方的物联网开发框架，适用于 ESP32、ESP32-S 和 ESP32-C 系列 SoC。它基于 C/C++ 语言提供了一个自给自足的 SDK，方便用户在这些平台上开发通用应用程序。

获取 ESP-IDF 最简单的方法就是通过 ESP-IDF 工具安装器来获取，使用这种方式，可以实现一路 next 傻瓜式安装；如果不使用 ESP-IDF 工具安装器，在单独下载完 ESP-IDF 后，还需要手动安装 ESP-IDF 使用的各种工具，例如编译器、调试器、Python包等等。

---

ESP-IDF 工具安装器下载：
https://dl.espressif.com/dl/esp-idf/?idf=4.4

这里可以看到有在线安装和离线安装两种方式，其主要区别如下：

• 在线安装程序很小，安装过程中只下载必要的依赖文件，需要网络
• 离线安装程序较大，安装程序中包含所有需要的依赖文件，不需要网络

---

1.2 安装 ESP-IDF 工具安装器

ESP-IDF 工具安装器下载完成后，运行安装程序：

选择接受协议以后，安装程序会检测当前系统环境：

检测通过后点击下一步，这里会让你选择是下载 ESP-IDF 还是使用已有的 ESP-IDF；如果此前你已经单独下载好 ESP-IDF ，则直接选择所在路径即可；此前没有单独下载过 ESP-IDF 的话，这里选择下载 ESP-IDF：

选择当前最新 v4.3 版本以及 ESP-IDF 存放路径：

选择 ESP-IDF 所需工具的安装路径：

选择所需组件，如果不知道如何选择，则保持默认即可：

点击安装后，会弹出一些安装窗口，全部选择安装即可:

经过漫长的等待，ESP-IDF 以及所需的工具就全部安装完成：

---

注意事项：

• ESP-IDF 和 ESP-IDF 工具的安装路径不能超过 90 个字符，安装路径过长可能会导致构建失败
• Python 或 ESP-IDF 的安装路径中一定不能包含空格或括号
• 除非操作系统配置为支持 Unicode UTF-8，否则 Python 或 ESP-IDF 的安装路径中也不能包括特殊字符（非 ASCII 码字符）

---

2、VSCode 插件安装使用

其实经过上述的安装步骤后，可以直接使用 ESP-IDF 开发 ESP32 应用程序了，但是使用命令行来配置、编译、烧录，未免显得有点繁琐，要是有类似 Keil 这样的IDE，开发流程就简洁多了。

乐鑫显然很懂开发者的这点小心思，提供了 Espressif IDF 插件，在 VSCode 上安装了该插件后，就可以实现一键编译、烧录应用程序了，非常方便。

---

2.1 安装插件

首先打开 VSCode ，在插件市场中搜索 “Espressif IDF” 关键字，安装 Espressif IDF 插件：

按 F1 进入命令面板，输入 “ESP-IDF: Configure ESP-IDF” ，点击进入：

如果上述步骤中的 ESP-IDF 没有安装成功的话，这里只会有两个选项：

如果上述步骤中的 ESP-IDF 安装成功，这里会检测到已安装的 ESP-IDF，就会有三个选项：

选择 USE EXISTING SETUP 选项，如果所有工具都安装成功，就会看到如下信息：

---

2.2 编译例程

打开 ESP-IDF 所在路径，有个 examples 目录，里面有各个组件的例程，后续可以参照这些例程开发自己的应用程序：

初次编译，我们选择个简单的例程，复制 examples/get-started 路径下的 hello_world 到自己的工程路径下：

VSCode 创建工程并加载 hello_world 例程，点击左下角的编译按钮即可开始编译：

左下角的工具栏里面，有构建、烧录、监控 等按钮，可以实现一键编译、烧录等操作，非常方便。

编译成功后，在工程目录下会生成一个 build 目录，里面存放有编译生成的 bin 文件：

至此，VSCode 的开发环境就搭建、验证成功了。

---

2.2 烧录例程

将开发板连接到电脑，点击左下角工具栏中的串口选项，选择开发板串口：

在点击左下角工具栏中的烧录选项，开始烧录程序，如果是初次烧录，还会弹出烧录选项让你选择，这里用的的串口烧录：

烧录完成后，点击左下角工具栏中的监控选项，看看程序是否正常运行：

看到程序正常输出 Hello world! ，表明一切正常。

---

总结

本文仅介绍了 ESP32 开发环境的搭建，这只是万里长征的第一步，后续我持续分享更多 ESP32 的开发心得，喜欢的小伙伴可以多多关注，相互学习交流。