ESP-IDF+VSCODE环境适配安装教程--基于win10开发环境

一. 各组件关系说明

大多数的GEEKER或者ESP学习者都会被ESP32系列强大的功能和开箱即用的component库所吸引。这对于快速开发有很大的借鉴意义。但正由于提供功能多样性和复杂度，加上前期乐鑫官方的开发适配版本混乱。大多数人都在第一步被劝退。笔者也是折腾了一个周末加两个晚上才把安装流程窥见门道。

• VMWARE 虚拟机平台工具（非必须）
• win10 iso包 win10系统镜像安装包（非必须）
• ESP-IDF 官方编译工具链
• VSCODE 代码浏览和编译的IDE
• espressif idf vscode内的ESP-IDF环境配置拓展组件
• python 用于在IDE和编译工具链之间进行沟通的脚本桥梁

二.版本准备

1）.ESP-IDF V5.1.1 版本安装----还未适配LVGL开源图形库

1）首先搭建win10虚拟机系统环境
2）在虚拟机中安装vscode
vscode国内镜像下载参考教程
3）在vscode中安装1.6.4

4）打开 espressif IDF,配置插件安装(快捷键 ctrl+shift+p，然后输入configure esp-idf)
安装教程参考链接

2）.ESP-IDF V4.4.5 版本安装----适配LVGL V8.3

该版本安装相校最新版本的安装要复杂一些，请耐心按照步骤一步步实现
1）首先搭建win10虚拟机系统环境
2）下载 ESP-IDF V4.4.5离线安装包
乐鑫安装包下载链接地址


3）安装离线包
安装成功显示页面

选择的安装路径下出现的IDF框架，工具组件和Python虚拟环境

4）.设置pip镜像源！！！

这一步非常重要。镜像源不对会导致获取的python工具链各脚本和组件版本不匹配(IDF和expressif idf不同版本组件下会有requirements.txt文件，这里面就会对工具链所涉及到的组件进行版本要求和规范)，或者一些国外的源网站无法访问或访问慢导致安装VSCODE拓展失败。

• 1>.进入IDF python虚拟环境对应的python.exe路径
  
• 2>.设置pip源为tsignhua

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

出现上图中Writing to xxx\pip.ini即表示成功切换pip源

5）.安装VSCODE
vscode国内镜像下载参考教程

！！！如果之前安装过vscode ，并配置IDF拓展不成功，可以考虑将VSCODE组件完全移除再进行安装

• 1>.控制面板卸载VSCODE
• 2>.删除code文件夹残留数据
  
  
• 3>.删除.vscode文件夹残留数据
  
  6）.安装 ESPRESSIF IDF VSCODE拓展
  
  ！！！此处注意要对应安装 v1.5.0，否则可能Python版本获取过高，安装失败，该版本对应Python版本为3.8.7，符合IDF V4.4.5 VSCODE拓展要求，切换ESPRESSIF IDF版本如下图所示
  
  7).配置IDF拓展插件路径，ctrl+shift+p进入vscode命令栏，搜索Configure ESP-IDF extension，并点击
  
  8）配置安装即可
  这里注意跟链接中差别就是不需要再下载ESP-IDF包了，选择本地路径安装即可(现在离线安装的ESP组件的位置)
  安装教程参考链接
  9）.安装成功，毕业
  
  PS：如果此时打开一个实例工程编译失败，可以尝试在 idf的powershell框中用idf.py build去运行示例工程，会提示如何完善编译环境
  
  
  

三.补充：实现多版本ESP-IDF VSCODE兼容

笔者由于电脑存储比较大，所以开了两个虚拟机分别装IDF 4.4.5和IDF 5.1.1
如果有想尝试的小伙伴可以参考下面链接，大致原理就是下载两个版本ESP-IDF组件库，然后VSCODE设置两份参数文件(保存不同版本的xxx.setting,xxx.json配置)
IDF多版本兼容参考链接