一、安装Visual Studio Code

下载地址：Download Visual Studio Code - Mac, Linux, Windows

打开上方链接，选择页面中的Windows版本，单击下载

将下载好的VSCodeUserSetup-x64-1.89.1.exe。单击右键，选择以管理员身份运行，开始安装

在安装界面中勾选 我同意此协议 然后单击 下一步 按钮。

在接下来的界面中，勾选 所有选项 ，然后单击 下一步 按钮

在接下来的界面中，直接单击 安装 按钮

接下来等待安装完成

安装完成，单击完成按钮

二、Visual Studio Code设置中文

同时按Ctrl + Shift + X 快捷键
在左侧“扩展”视图文本框中输入“Language Packs”，找到Chinese 中文插件，单击绿色的Install安装按钮，这里我们安装的是中文简体，安装完成右下角弹出一个重启按钮，点击重启，语言自动切换

三、安装C/C++扩展

同样的方式搜索C/C++，安装C/C++扩展来支持C语言代码高亮

四、打开ESP32工程

方式一

VSCode中打开ESP32的代码工程，可以直接打开代码所在的文件夹即可，文件菜单选择打开文件夹，选择一个源码目录打开

方式二

直接在工程文件夹下单击右键，选择 通过Code打开

打开后的文件结构

 五、安装Espressif IDF插件

在VSCode扩展插件中搜索 ESP，找到ESP-IDF，单击安装按钮

等待插件安装完成后，在VSCode中使用快捷键：Ctrl + Shift + P调出VSCode的命令面板，并输入“ESP Welcome”，单击ESP-IDF:Welcome。打开ESP配置页面

在页面中单击 Configure extension 配置扩展按钮

选择设置为全局 Global 然后选择 EXPRESS 开始配置

1、在此页面中选择ESP服务器为 Espressif

2、选择ESP-IDF版本为最新发行版  V5.2.1(release version) 

3、选择你的本地IDF库安装目录：F:\ESP32\Espressif 

4、选择你的本地IDF库工具安装目录：F:\ESP32\Espressif

F:\ESP32\Espressif 是我自己创建好的目录，第三个目录会自动在后面添加\esp-idf目录 ，所以3和4这里填写同一个目录即可。建议不要使用C盘，尽量挑大一点的磁盘。

确保目录正确且都存在，然后单击页面右下角的 Install 安装按钮

这里要安装非常久，耐心等待。

接出现如下界面，提示：Visual Studio代码的ESP-IDF扩展 所有设置都已配置。你可以关闭这个窗口。

四、Espressif IDF插件使用

依照上图Espressif IDF插件基本菜单一共12个，常用的只有两三个，依次为

1、选择串口（插头）：即连接开发板的下载串口号，VS会列出当前连接电脑的所有串口让你选择，这个会记录，再新打开VSCode不用重新选择，开发过程中尽量不要更换USB线的电脑插口，否则串口号会变。

2、选择目标芯片：对应idf命令idf.py set-target xxxx。即你当前这个工程是要下载到什么芯片上面，如ESP32 S2,S3,C2,C3等等，工程要与芯片相匹配，这个选择是写入当前工程配置的，一般不用更改，工程下配置文件基本已经选择好的。

3、选择当前工程目录（文件夹）：也不用修改，一般打开工程时会默认操作都在这个工程目录下

4、工程配置菜单（齿轮）：对应idf命令idf.py menuconifg，用来配置当前工程的一些设置，配置项非常多，建议使用到再修改。一般代码工程都是配置好的，且不用修改

5、清除工程（垃圾桶）：清除工程编译文件，一般用于压缩拷贝工程文件时用到，清除后工程目录占用空间会占用非常小，KB级，编译后为百MB级，还有一些编译过程中奇奇怪怪的问题也可以先清除编译后再编译

6、编译工程（圆柱体）：编译当前工程，只是编译，没有下载功能

7、选择下载模式（五角星）：一般都是选择串口UART方式下载

8、下载（闪电）：下载编译好的固件到设备芯片上，这里只是下载，没有编译功能，修改代码后要先编译再点这个下载，所做的修改才有效。

9、串口监控（小电视）：打开与设备连接的串口，打印设备串口信息

10、编译/下载/监控（一团火）：最常用的一个，它将编译下载和打开串口监控做在了一起，点一次全部搞定

11、打开命令行：打开命令行窗口，且会定位在当前项目路径下，可以执行idf的一些命令

12、执行自定义任务：不使用

五、头文件包含、无法跳转、波浪线问题解决

打开ESP32工程头文件波浪线不能跳转，并且提示“在browse.path中未找到包含文件”等等引用错误提示。

1、按前面的四步安装配置好IDF插件后，删除源码目录中 <.vscode>文件夹。

2、在VSCode中使用快捷键： Ctrl + Shift + P 调出VSCode的命令面板，并输入查找“添加”，选择 添加 vscode配置文件夹

选择“ESP-IDF:添加 vscode 配置文件夹”，VSCode 会自动在源码目录下的<.vscode>文件夹中生成对应的配置文件，对应的红色波浪线也消失了，按住Ctrl 键用鼠标单击你想查看的头文件或函数，就可以跳转了。