如何使用 Gitee 快速搭建 ESP-IDF 开发环境（Windows 版本）_飞道的博客

如何使用 Gitee 快速搭建 ESP-IDF 开发环境（Windows 版本）

2021-01-15 12:41 356人阅读评论(0)

前言

为了提高代码仓库的访问速率，更好的满足中文用户沟通需求，我们现已将部分主要仓库镜像到码云（Gitee，中国本土化的基于 Git 的代码托管平台），包括深受用户喜爱的乐鑫物联网开发框架 ESP-IDF，Wi-Fi 自组网开发框架 ESP-MDF ，腾讯、京东、阿里等中国国内云平台连云代码等基于码云的同步机制，各个仓库会按时执行代码镜像操作，确保与 Github 平台保持一致。值得一提的是，我们还将 ESP-IDF 依赖的子仓库（submodule）代码逐一镜像到了码云，确保主仓库和子仓库拥有相同的下载体验。码云仓库主页：https://gitee.com/EspressifSystems

该教程可作为对官方搭建教程的补充，使用码云进行 ESP-IDF 环境安装，预计可大幅缩短环境搭建的等待时间。

适用系统：Windows 10 64 位版本、Windows 7 SP2 级以上 x64 版本

安装版本：ESP-IDF 4.0 及以上版本

构建系统：CMake

一、安装依赖工具

在环境搭建之前，我们需要在 Windows 系统中安装一些开发必备的工具，这些工具包括 Python 环境，版本控制工具 Git。

1. 安装 Python 3.7：

Python 主要用于执行一些自动化脚本，例如执行 idf.py 等；
下载链接：点击下载: python3.7.9；
安装提示：

注意，在安装时先勾选 Add Python 3.7 to PATH，或手动添加环境变量 >

修改 Python pip 源：

为了加快后续 Python 包的下载速度，可将 pip 源切换到国内，例如切换为国内阿里的源

管理员模式打开命令提示符窗口（ CMD），执行以下指令：
```
pip config set global.index-url http://mirrors.aliyun.com/pypi/simple
pip config set global.trusted-host mirrors.aliyun.com
```

2. 安装 Git：

Git 用于拉取 ESP-IDF 源代码，代码版本控制等；
下载链接：点击下载: git 2.30
安装提示：直接点击下一步即可

注意，以上步骤完成以后，请重启电脑使配置生效

二、下载 ESP-IDF 源代码

ESP-IDF 的仓库代码包含一个主仓库和数十个子仓库，使用重定向脚本 esp-gitee-tools ，可以直接将这些仓库的下载路径切换为国内码云仓库，极大的加快代码的下载速度，操作方法如下：

进入 C 盘根目录；
打开一个终端窗口：可在文件管理器空白位置点击鼠标右键，然后选择 Git Bash Here；

下载重定向脚本 esp-gitee-tools，运行以下指令：

git clone https://gitee.com/EspressifSystems/esp-gitee-tools.git

下载主仓库代码：

git clone https://gitee.com/EspressifSystems/esp-idf.git

使用 esp-gitee-tools 下载子仓库代码，依次执行以下指令：

cd esp-gitee-tools
export EGT_PATH=$(pwd)
cd ..
cd esp-idf
$EGT_PATH/submodule-update.sh

后续如果切换了 git 分支，子仓库列表可能会有变化，需要重复执行步骤 5 的指令

三、安装编译工具链

为了生成最终能在 ESP 芯片上运行的 bin 文件，这里还需要安装芯片对应的编译工具链和构建系统，工具链相关的下载信息一般在 ESP-IDF 中附带，我们这里使用 esp-gitee-tools 进行下载，步骤如下：

进入 C 盘根目录；
同第二步类似，打开一个终端窗口；

使用 esp-gitee-tools 安装编译工具链，执行以下指令：

cd esp-gitee-tools
export EGT_PATH=$(pwd)
cd ..
cd esp-idf
$EGT_PATH/install.sh

至此环境安装的过程已经完成

四、使用 VS Code 编译运行 Hello world ！

用户可以使用任意编辑器编写源代码，我们这里推荐使用 VS Code，下载链接：点击下载 VS Code。编译、下载、运行过程如下：

启动 VS Code，打开内置终端窗口，快捷键为 Ctrl + ~

这里建议将默认终端切换为命令提示符 CMD

重启 VS Code ，打开工程文件夹，这里打开的是 C:\esp-idf\examples\get-started\hello_world

打开终端，编译、下载、查看输出：
4.1. 首先使用命令C:\esp-idf\export.bat 添加环境变量到当前终端（开启新终端需要重新执行）：

4.2. 使用命令 idf.py build 编译代码：

4.3. 使用命令 idf.py -p COMX flash monitor 下载代码，并查看串口输出：