乐鑫代理启明云端分享| ESP32系列教程之五： Eclipse搭建esp-idf环境

提示：前面小明已经为大家分享了4个章ESP32系列教程，今天继续为大家分享，希望大家多多关注我们！启明云端作为乐鑫代理，一直希望能帮到更多的开发者能快速上手乐鑫系列芯片的开发。

---

前言

提示：本文档为ESP32教程系列，旨在为客户进行ESP32系列芯片开发提供环境搭建、工程示例演示等方面的参考文档及视频演示，降低ESP32系列芯片、模组开发的入门难度。
ESP32教程系列文档主要参考于乐鑫官网提供的ESP32入门教程：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/index.html。

---

1. 工具链设置

1.1安装git

1.1.1.下载

git下载地址：https://git-scm.com/downloads

1.1.2 安装

（1）下载

（2）设置安装路径

（3）一直NEXT，直至完成安装

1.2 安装python（版本3.5以上）

1.2.1 下载

python下载地址：https://www.python.org/downloads/

1.2.2 安装

（1）下载

（2）安装



1.3 获取ESP-IDF
方式一：在文件夹下打开git，使用下方命令下载esp-idf（下载的esp-idf位置在当前文件夹）：

git clone -b release/v4.3 --recursive
https://github.com.cnpmjs.org/espressif/esp-idf.git （注：-b
release/v4.3表示当前下载版本为release/4.3,需要下载其它版本或版本介绍请移至乐鑫官网查看具体介绍

出现如下错误：

进入esp-idf目录下执行：git submodule update --init --recursive

方式二：前往乐鑫官网下载esp-idf压缩包，解压后改名为esp-idf,下载地址：
https://www.espressif.com/zh-hans/support/download/sdks-demos?keys=&field_type_tid%5B%5D=13

1.4 安装Java（Java 11及以上）

1.4.1 下载

Java下载地址：https://www.oracle.com/java/technologies/javase-downloads.html

1.4.2 安装

一直下一步，直至安装完成。

1.5 安装Eclipse

1.5.1 下载

Eclipse下载地址：https://www.eclipse.org/downloads/

1.5.2 安装

（1）选择C++

（2）选择Java路径

（3）启动Eclipse

1.6 构建esp-idf环境

1.6.1 安装ESP-IDF插件

（1）选择help -> Install New Software

（2）在弹出的页面单击add…，输入：

Name:Espressif IDF Plugin for Eclipse

Location:https://dl.espressif.com/dl/idf-eclipse-plugin/updates/latest/

（3）从列表中选择并继续安装Espressif IDF（可只选择以下三项）

（4）等待安装完成

注意：一定要等待安装完成，时间可能较久，如果网络不好进度条卡住可以按照上述步骤重新执行一遍。中间可能出现警告，可以不用管，选择继续安装。

（5）重启Eclipse，出现如下图标说明插件安装完成。

1.6.2 安装ESP-IDF工具

（1）选择help -> ESP-IDF Tools Manager -> Install Tools

（2）提供文件路径

（3）等待安装完成

（4）重置菜单Window > Perspective > Reset Perspective…

（5）出现新选项：File -> New -> Espressif IDF Project

---

2 .运行hello_world示例

2.1 新建工程

（1）提供工程名称

（2）选择工程模板

（3）工程创建成功

（代码显示的错误不用理会，构建工程后会消失）

2.2 工程配置

（1）配置编译目标

（2）选择ESP Target

（3）设置IDF目标和端口号（本次示例使用的是ESP32-C3）

2.3 编译工程

（1）点击小锤子进行编译或点击开始进行编译与烧录

（2）开始编译、烧录


烧录成功！

2.4 监视工程

（1）启动监视终端，配置端口号

（2）查看打印信息

成功打印hello_world.

2.5 查看程序大小分析

（1）右键单击项目，选择ESP-IDF: Application Size Analysis

（2）查看应用大小分析

---

3. 后 记

3.1 注意事项

• git版本没有具体要求
• python版本应为3.5以上（建议3.8或3.9）
• Java版本应为Java11以上
• 建议先下载好4.3版本（最新版）的esp-idf
• ESP-IDF插件安装失败可以重新执行步骤1.6
• 记得进行一次菜单重置，否则大概率看不见Espressif IDF Project选项

3.2 相关建议

• 和教程二（Linux）及教程四（Windows）所提供的esp-idf环境构建方法相比，Eclipse在工程编译速度方面明显较为缓慢，但其工具链设置较为简单且不易出错，界面化的操作对于不习惯命令控制的开发者较为友好，可对程序大小进行分析的功能则是其独特优势，对编译速度不敏感或喜欢界面操作开发的开发者可选择此方式进行ESP32开发。

• 本文档仅对Eclipse进行ESP32开发的基础功能进行探讨，未对Eclipse的其它功能进行深入研究，想要对Eclipse功能进行深入了解的开发者可前往乐鑫官网自行查看相关文档。

---

启明云端

深圳市启明云端科技有限公司（简称“启明云端”）是国内领先的物联网通讯产品和整体解决方案提供商，为全球企业客户提供无线通讯产品及场景智能化服务。

公司作为Espressif（乐鑫科技）大中华区合作伙伴，Sigmastar（晨星）A级方案商；得天独厚的上游芯片厂商资源及严格的质量控制体系为公司发展提供强大的实力保证，总能在第一时间为客户带来极具竞争力的产品。

公司主要提供物联网无线通讯芯片、模组、人机界面（HMI）、人工智能及工业控制嵌入式产品等，方案已服务全球超过1000+企业，特别是在智能家电、智能家居、智慧工业、医疗、农业监测等领域积累了丰富的产品和项目经验。