ESP32开发环境搭建Windows VSCode集成Espressif IDF插件ESP32_IDF

这篇具有很好参考价值的文章主要介绍了ESP32开发环境搭建Windows VSCode集成Espressif IDF插件ESP32_IDF_V5.0开发编译环境搭建。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

一、安装ESP32-IDF库

下载网址：https://dl.espressif.com/dl/esp-idf/

打开上面的网页，选择单击页面中 ESP32-IDF v5.0.2 - Offine Installer，5.0.2是当前最新版本，如果没有ESP32-IDF v5.0.2 - Offine Installer，说明官方有更新最新版本，如果想要安装此教程版本可以把页面翻到最下面，会列出所有历史版本供用户下载。

注意：ESP-IDF库各版本之间API函数各有差异，版本号差别越大，差异越大，如果是新手小白还是尽量遵循你的开发板卖家或你找的源码教程中的版本来。

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

下载成功后，在安装程序上单击右键选择 <以管理员身份运行>打开程序。

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

打开安装程序后选择简体中文安装

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

勾选我同意协议，单击下一步按钮。

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

如果是第一次安装，会出现如下提示。

安装程序会检查你当前系统有没有打开"长路径支持"，因为GNU编译器产生的编译文件会有非常深的目录结构，如果不支持长路径，编译可能出现文件不存在，目录不存在等奇怪的错误。这里单击应用修复按钮，可以修复这个问题。

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

在弹出的确认对话框中，选择是，开始修复 vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

修复完成，单击下一步 vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

安装程序会提示修复成功；单击下一步。

注意：如果修复不成功，一般情况是安装软件打开时没有使用管理员权限打开，可以手动修改注册表来支持长路径：打开注册表HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\LongPathsEnabled 设置为 1。该操作需要管理员权限。

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

接下来一步，开始选择安装目录，安装程序默认的安装位置为 C:\Espressif，但这里我是安装在F盘，如果全部源码编译后可能产生几十G的大小占用，我的F盘空间很大，我在F盘创建了两个文件夹，

一个 <ESP32> 文件夹放IDF库及后面学习用到的ADF，MDF等官方库。

一个 <ESP32_File> 文件夹放置所有的源码工程。

注意：强烈建议安装在其它盘符

原因1：有些电脑默认C盘空间较小，ESP-IDF安装后有几个G大小

原因2：使用命令行工具操作配置源码工程需要切换目录，多一步操作，而且源码工程编译会生成大量文件，每个工程都会有一两百MB的占用空间。

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

下一步，确认安装组件，这里全部打勾，默认完全安装时ESP32 C2是不打勾的，看需要自己选择。然后单击下一步 vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

再次确认安装目录信息，然后单击安装。 vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

开始解压离线安装文件，静静等待它完成 vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

安装完成。三个全部勾选，1、2用于测试环境安装是否成功，3是将IDF工具链加入杀毒工具排除项，以加快编译速度。 vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

单击完成后出现如下两个窗口，一个是PowerShell命令行，一个是传统的cmd命令行窗口。显示如下内容，说明可以进行工程编译了。

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

二、检查设置环境变量

安装IDF库完成后，虽然使用命令行的方式可以编译工程了，但每次使用命令行着实不方便，这里检查并创建两个环境变量，为把ESP32编译集成到VSCode中做准备。

重要的一步，检查你的系统环境变量，在用户变量中检查是否有 IDF_PATH和IDF_TOOLS_PATH这两个环境变量，如果没有的话，创建一下，注意你自己刚才安装ESP-IDF库的目录。

打开电脑的用户环境变量设置，计算机属性->高级系统设置->环境变量->xx用户环境变量：

IDF_PATH ： ESP-IDF库的路径

IDF_TOOLS_PATH ： ESP-IDF编译工具链的路径

检查并创建这两个用户变量，像我的变量如下，你们参照刚才安装ESP-IDF库的目录创建，确保目录确实存在

IDF_PATH ： F:\ESP32\Espressif\frameworks\esp-idf-v5.0.2

IDF_TOOLS_PATH ： F:\ESP32\Espressif

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

三、Visual Studio Code配置

下载地址：Visual Studio Code - Code Editing. Redefined

Visual Studio Code编辑器在Windows上安装比较简单，直接setup.exe。一路下一步，安装好后首次启动配置插件，插件配置必须联网，从网上下载

设置中文

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

安装C/C++扩展

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

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

打开ESP32工程

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

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

打开后的文件结构 vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

安装Espressif IDF插件

在VSCode扩展插件中搜索 Espressif IDF，单击安装按钮

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

安装完成

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

配置Espressif IDF插件

单击VSCode设置齿轮菜单，弹出菜单选择设置

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

在打开的设置页面右上角单击 <以JSON打开设置> 的一个按钮

vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

将设置以JSON方式打开，上面的是我自己创建的一些设置，下面是Espressif IDF插件根据ESP环境变量自动生成的一些配置，不用更改下面的，看自己情况更改上面的 vscode esp-idf,ESP32,ESP32 HelloBug开发板教程,vscode,esp32,ESP32-IDF,Espressif IDF

这里贴出我的完整配置：

{
	"editor.insertSpaces": false,				// 自动插入空格禁用
	"editor.detectIndentation": false,			// 启用时根据文件内容进行重写
	"editor.renderControlCharacters": true, 	// 是否显示控制字符：启用
	"editor.renderWhitespace": "all",			// 显示4个空格是....
	"editor.tabSize": 4,						// tab设置为4个空格
	"editor.fontSize": 18,						// 代码字体大小
	"editor.fontFamily": "Monaco, 'Courier New', monospace", // 代码字体
	"update.mode": "manual",					// 设置不自动更新

	
	"cmake.configureOnOpen": true,
	"idf.adapterTargetName": "esp32",
	"idf.espIdfPathWin": "F:/ESP32/Espressif/frameworks/esp-idf-v5.0.2/",
	"idf.pythonBinPathWin": "F:/ESP32/Espressif/python_env/idf5.0_py3.11_env/Scripts/python.exe",
	"idf.toolsPathWin": "F:\\ESP32\\Espressif",
	"idf.customExtraPaths": "F:\\ESP32\\Espressif\\tools\\xtensa-esp-elf-gdb\\11.2_20220823\\xtensa-esp-elf-gdb\\bin;F:\\ESP32\\Espressif\\tools\\riscv32-esp-elf-gdb\\11.2_20220823\\riscv32-esp-elf-gdb\\bin;F:\\ESP32\\Espressif\\tools\\xtensa-esp32-elf\\esp-2022r1-11.2.0\\xtensa-esp32-elf\\bin;F:\\ESP32\\Espressif\\tools\\xtensa-esp32s2-elf\\esp-2022r1-11.2.0\\xtensa-esp32s2-elf\\bin;F:\\ESP32\\Espressif\\tools\\xtensa-esp32s3-elf\\esp-2022r1-11.2.0\\xtensa-esp32s3-elf\\bin;F:\\ESP32\\Espressif\\tools\\riscv32-esp-elf\\esp-2022r1-11.2.0\\riscv32-esp-elf\\bin;F:\\ESP32\\Espressif\\tools\\esp32ulp-elf\\2.35_20220830\\esp32ulp-elf\\bin;F:\\ESP32\\Espressif\\tools\\cmake\\3.24.0\\bin;F:\\ESP32\\Espressif\\tools\\openocd-esp32\\v0.11.0-esp32-20221026\\openocd-esp32\\bin;F:\\ESP32\\Espressif\\tools\\ninja\\1.10.2;F:\\ESP32\\Espressif\\tools\\idf-exe\\1.0.3;F:\\ESP32\\Espressif\\tools\\ccache\\4.6.2\\ccache-4.6.2-windows-x86_64;F:\\ESP32\\Espressif\\tools\\dfu-util\\0.9\\dfu-util-0.9-win64;F:\\ESP32\\Espressif\\tools\\esp-rom-elfs\\20220823",
	"idf.customExtraVars": {
		"OPENOCD_SCRIPTS": "F:\\ESP32\\Espressif\\tools\\openocd-esp32\\v0.11.0-esp32-20221026/openocd-esp32/share/openocd/scripts",
		"IDF_CCACHE_ENABLE": "1",
		"ESP_ROM_ELF_DIR": "F:\\ESP32\\Espressif\\tools\\esp-rom-elfs\\20220823/"
	},
	"idf.gitPathWin": "F:/ESP32/Espressif/tools/idf-git/2.39.2/cmd/git.exe",
	"git.openRepositoryInParentFolders": "never"
}