【1】ESP-IDF零基础入门 —— 搭建开发环境1

---

前言

ESP-IDF 是乐鑫官方的物联网开发框架，也是最基础的开发框架，其他的框架，例如音频开发框架 ESP-ADF 也是基于 ESP-IDF 的，所以说 ESP-IDF 框架是学习乐鑫 ESP32 系列芯片开发绕不过去的一道坎。

---

1. ESP-IDF 的爱与恨

ESP32系列芯片功能很强大，但是 ESP-IDF 获取与安装却很令人头疼，看到那么多小伙伴吐槽就可以略窥一二了：

不少小伙伴看到 ESP32 系列芯片强大的功能后，兴致勃勃地开始学习，不曾想在安装开发环境的时候就碰到了一鼻子的灰，不少人还直接被劝退，哈哈，大可不必，其实只要掌握好几个要点，ESP-IDF安装是很简单的，跟着我的步骤来，相信你也能轻松搭建好开发环境。

---

2. 安装ESP-IDF的大杀器

网上关于 ESP-IDF 的安装教程多如牛毛，安装的方式也是五花八门，当你跟着某个教程一步步操作时，发现问题还是一大堆，为什么别人这么搞可以，我照着来就不行，换个不一样的教程再来一遍，又何能还是失败，多弄几次，心态就容易崩。

其实按照我失败了n次，从n个坑里爬出来后得到的结论来看，ESP-IDF 安装失败主要有如下三个原因：

• ESP-IDF源码下载不完整
• 相关工具安装不完整
• 环境变量配置有问题

ESP-IDF 的源码托管在 GitHub 上，国内的小伙伴访问 GitHub 下载 ESP-IDF 源码时，速度很慢，连接也不稳，很容易就断开导致源码下载失败；另外，ESP-IDF 源码仓库中还有很多子模块，单纯用 git clone 命令下载是不行的，上述原因都将导致 ESP-IDF 源码下载不完整，后面的步骤肯定都会有问题。

---

除了获取到完整的 ESP-IDF 源码外，一些必要的工具也是必不可少的，例如：CMake 工具、Ninja 编译工具、Python 等，如果这些必需的工具没有安装好，编译程序的时候就会报错。

---

环境变量的重要性就更不用说了，没有配置好的话，编译、烧录等命令都无法识别。

ESP32 开发环境搭建，有如下三个关键步骤：

• 获取 ESP-IDF
• 设置工具
• 设置环境变量

这三个关键步骤没有做好的话，大概率会出现上述的错误，因此，作为初学者，要想较为轻松地搭建好开发环境，就要避开上面容易踩坑的地方。

乐鑫提供了极为简单的 ESP-IDF 安装方式 —— 使用 ESP-IDF工具安装器。我非常推荐初学者使用这种方式搭建开发环境，等到入门以后，再考虑更高阶的做法。

说明：
下面讲到的开发环境都是基于 Windows 操作系统的，Linux 操作系统搭建开发环境后续再更新。

---

3. 获取 ESP-IDF 工具安装器

使用 ESP-IDF 工具安装器时，就跟你平时安装软件一样，选好所需的功能组件，选择好安装的目录，一路 next 就可以了安装好 ESP-IDF 了，十分简洁高效。

ESP-IDF 工具安装器程序有两种。第一种是在线安装程序，优点是程序非常小，只要区区几M，可以安装 ESP-IDF 的所有版本；缺点是安装时需要联网下载必要的依赖文件，下载的速度可能和 GitHub 下载一样慢，等到发狂。

第二种是离线安装程序，优点是安装程序中包含了所有需要的依赖文件和工具；缺点是程序比较大，好几百M。

这里建议大家不要想那么多，坚定不移地选择离线安装程序即可，离线安装程序一般都是安装当前最新版本的 ESP-IDF，如果需要使用其他版本的 ESP-IDF ，可以等到入门熟悉后再单独配置即可。

点击下载 ESP-IDF 工具安装器 ==> ESP-IDF 工具安装器

---

小结

下一节将介绍如何使用 ESP-IDF工具安装器安装 ESP-IDF ，介绍如何使用命令编译、烧录、监控应用程序，介绍如何在 VSCode 中安装 ESP-IDF 插件关联已经安装好的 ESP-IDF。