提示：启明云端从2013年起就作为Espressif（乐鑫科技）大中华区合作伙伴，我们不仅用心整理了你在开发过程中可能会遇到的问题以及快速上手的简明教程。同时也用心推出了基于乐鑫的相关应用方案！希望你能第一时间了解并快速用上好的方案和产品！
本文档为ESP32教程系列，旨在为客户进行ESP32系列芯片开发提供环境搭建、工程示例演示等方面的参考文档及视频演示，降低ESP32系列芯片、模组开发的入门难度。
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、 参考视频（B站搜启明云端）
4 后 记
4.1 注意事项
（1）git版本没有具体要求
（2）python版本应为3.5以上（建议3.8或3.9）
（3）Java版本应为Java11以上
（4）建议先下载好4.3版本（最新版）的esp-idf
（5）ESP-IDF插件安装失败可以重新执行步骤1.6
（6）记得进行一次菜单重置，否则大概率看不见Espressif IDF Project选项
4.2 相关建议
和教程二（Linux）及教程四（Windows）所提供的esp-idf环境构建方法相比，Eclipse在工程编译速度方面明显较为缓慢，但其工具链设置较为简单且不易出错，界面化的操作对于不习惯命令控制的开发者较为友好，可对程序大小进行分析的功能则是其独特优势，对编译速度不敏感或喜欢界面操作开发的开发者可选择此方式进行ESP32开发。
本文档仅对Eclipse进行ESP32开发的基础功能进行探讨，未对Eclipse的其它功能进行深入研究，想要对Eclipse功能进行深入了解的开发者可前往乐鑫官网自行查看相关文档。
