Windows平台下Vscode配置ESP-IDF extension流程

1. 前提：安装Git 和 Python。

2. 打开Vscode，点击左侧的Extensions图标，在搜索框搜索Espressif IDF，点击安装。

3. 键盘按F1-> 在出现的搜索框中输入 ESP-IDF: Configure ESP-IDF extension

4. 点击ADVANCED, 拓展会自动识别Git version ，如果没有，那就关闭VScode，再重新打开。

选择Select download server: Espressif; Select ESP-IDF version: v4.2(release version); Enter ESP-IDF container directory: D:\esp; 点击Install.

上述设置就是让extension自动从乐鑫的服务器下载v4.2版本的ESP-IDF到PC的D:\esp目录下，如果从Github下载就太慢了。

Tips: ESP-IDF 可以手动通过Gitee从Github下载.zip文件，放到D:\esp文件下。

5. ESP-IDF 安装完成后，安装ESP-IDF Tools，路径保持默认的C:\Users\XXX\.espressif，ESP-IDF Tools 中的Cmake下载比较慢，可以去官网用迅雷下载，然后把Cmake压缩包放在在.espressif\dist路径下。

安装过程会进入到最后一步 Installing Python vitual environment for ESP-IDF。

在这个过程当中，ESP-IDF extension 会在C:\Users\XXX\.espressif\python_env\idf4.2_py3.9_env下创建了一个Python虚拟环境，然后在这个虚拟环境中安装wheel，pyserial，pyparsing等python模块；然而由于pip版本过低，这些python模块安装失败，这些模块影响串口连接、编译等功能。

6. 更新虚拟环境中pip 版本

在命令行进入虚拟环境所在文件夹C:\Users\XXX\.espressif\python_env\idf4.2_py3.9_env，输入activate命令，激活python虚拟环境，执行以下命令更新pip：

python -m pip install --upgrade pip

然后重启VScode，再执行一遍步骤1-5，等待Python虚拟环境安装完成

7.python 虚拟环境的报错(安装过程中的报错)

在安装虚拟环境过程中大概率还会报错，报错信息如下：

The followin Python requirements are not satisfied:

pyserial>=3.0

future>=0.15.2

cryptography>=2.1.4

pyparsing>=2.0.3,<2.4.0

pyelftools>=0.22

gdbgui==0.13.2.0

reedsolo>=1.5.3,<=1.5.4

bitstring>=3.1.6

ecfsa>=0.16.0

esp=windows-curses; sys_platform == 'win32'

以上带有版本号的比如gdbgui==0.13.2.0，是python模块，他们没有安装成功是因为在安装python模块中网速过慢，导致安装超时。

解决方案：按照步骤6，进入python虚拟环境，手动安装 报错失败的python模块

这里建议用清华镜像安装 ，例如lxml包安装失败，故输入命令

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple lxml。

逐个安装完Python模块后，需要运行d:\esp\esp-idf\install.bat，esp=windows-curses; sys_platform == 'win32'需要运行d:\esp\esp-idf\install.bat

注意：(1)d:\esp\esp-idf\install.bat如果运行没成功，原因是没有添加python路径到系统变量。

          (2)如果在手动安装gdbgui过程中报错，原因是PC缺少VC++ 2015编译工具，导致电脑无法编译下载的gdbgui包，VC++ 2015 Build Tools官方链接如下：

           https://www.microsoft.com/en-us/download/confirmation.aspx?id=48159

8. 重启Vscode，ESP-IDF: Configure ESP-IDF extension，选择好ESP-IDF和ESP-IDF Tools的路径，等待配置完成。

9. 最后F1->ESP-IDF: Create project ->Choose a container-> Template app, 这就创建了一个ESP32开发工程模板。