ESP32学习笔记( VSCode + ESP-IDF环境) 1 —— 环境配置

题记：坑是踩不完填不好的，填好也会有新的。

1、ESP-IDF在Windows环境下的配置

在一路CSDN、百度、乐鑫官方文档的检索、查阅之后，我决定不讲那些花里胡哨的东西，直接上流程。

1.1 准备内容

• 一台可以开机并可以正常使用的Win10操作系统的电脑（自己买不提供）
• ESP-IDF离线安装包（提取码：8066）

1.2 安装步骤

1. 双击 esp-idf-tools-setup-offline-2.11.exe 这个文件

2. 选择语言类型（中国人就选简体中文 想突破也不拦着）
   

3. 同意协议（有逆骨不介意安装）
   

4. 环境检测
   如果有问题就按照安装程序显示的进行修复就好，如果没问题就是以下界面：
   

5. 选择安装版本（目前乐鑫官方给出的最新版本为5.0.1）
   我提供的这个安装包是旧版本，但目前网上能找到的相关ESP32的教程视频或者博客几乎都是用的4.3版本（并且就连旧版本我都没整明白，不敢给你玩新的），所以选择4.3.1版本安装。（但凡ESP32大佬也不至于看我这个文章）
   安装路径以自己的电脑情况为准，但一定要记住自己的路径在哪，后续在VSCode中可能会用到。
   

6. 安装ESP-IDF Tools（同样，请记住自己的安装路径！）
   

7. 选择组件
   就按默认勾选的就行，如果你是用的是其他带后缀的ESP32芯片记得一定要看看有没有或者有没有勾选。
   

8. 确认安装路径并开始安装进度条
   注意：再次期间会有组件安装弹窗，记得允许安装。
   

9. 安装就结束了
   

1.3 测试是否安装成功（不行就要全删重来！）

1. 找到你ESP-IDF的安装路径，开始HelloWorld例程测试
   这就是前面让你记住的原因，进入之后按照这个路径：\esp-idf\examples\get-started\hello_world 找到hello_world工程

2. 复制路径
   

3. 打开桌面上的这两个图标中的任意一个（我开CMD）
   

4. 设置芯片信息 命令：idf.py set-target esp32
   设置成功就会出现如下界面：
   

5. cd切换到刚刚的工程路径下
   

6. 编译工程 命令：idf.py build
   第一次编译的时间会比较长，而且会显示很多内容，在编译通过之后会跳出烧写命令提示，基本如下：
   

7. 按照ESP32接入的端口号开始烧写 命令：idf.py -p 端口号 flash
   端口号查询：win标键 + x 进入设备管理器之后查看端口就能看到对应的端口号了。
   

8. 烧录成功之后通过窗口输出查看显示效果 命令：idf.py -p 端口号 monitor
   
   到这里，ESP-IDF在Windows环境下的安装就已经完成了。如果上述出现问题，请卸载干净后重新安装ESP-IDF。

2、VSCode以及所需插件安装

2.1 准备内容

• VSCode安装包（提取码：uroc）

2.2 安装和插件选择

1. 安装
   只需要双击安装包，选择路径即可，记得在完成后勾选“加入环境变量Path”。
2. 插件安装
   在安装完成VSCode之后，进入初始页面会让选择界面风格，选自己喜欢的即可。
   

• 中文插件（软件会根据系统语言自动推荐，安装完成需重启VSCode）
• Espressif插件
• C/C++插件

3. Espressif插件设置

   1. 点击左下角齿轮按钮，进入设置
      

   2. 在“用户” - “扩展” - “ESP-IDF”中找到“idf：Flash Type”设置，将Flash设置为“UART”。
      

   3. 继续和ESP-IDF环境配置一样，进入HelloWorld工程目录下，右击选择“VSCode打开”，就可以通过VSCode直接打开工程文件。

   4. 在VSCode界面中通过Ctrl + Shift + P的快捷键打开命令面板进行Espressif的配置

      • 输入：ESP-IDF:Configure ESP-IDF extension
      • 选择最后一项：use existing setup 从已经存在的环境安装
        
        接下来插件会自动识别你是否安装ESP-IDF和ESP-IDF Tools，然后自动判断是否欠缺工具。如果在这一步出现关于py的相关报错，先去你安装ESP-IDF Tools的目录中找到python_env\idf4.3_py3.8_env\Scripts路径，双击一下pip.exe，基本上就能解决，如果还不行，将错误信息粘贴到百度上就可以解决（百度大法好）。
        

      5. 安装完成
         安装完成会出现一个界面，提示你已经完成关闭本页面即可，至此插件配置完成。

      6. 回到刚刚我们打开HelloWorld工程界面，使用VSCode进行编译、烧写和输出查看
         在界面下方有关于ESP32的工具条，通过工具条就可以完成和使用ESP-IDF命令敲出来的编译 烧写一样的效果。
         PS：如果打开 .c文件发现#include头文件爆红，将鼠标点击在有红色波浪线处会出现一个黄色小灯泡，选择编辑“includePath设置”，进入后找到包含路径，在后面输入自己ESP-IDF和ESP-IDF Tools的目录即可。
         
         

      工具条如图所示：
      
      编译完成后，点击“小电视 ”效果：
      

至此，ESP-IDF和VSCode的安装和配置就此结束。预祝各位ESP32开发少坑，代码无红！