一、安裝ESP32-IDF庫

下載網(wǎng)址：https://dl.espressif.com/dl/esp-idf/

打開上面的網(wǎng)頁，選擇單擊頁面中 ESP32-IDF v5.0.2 - Offine Installer，5.0.2是當(dāng)前最新版本，如果沒有ESP32-IDF v5.0.2 - Offine Installer，說明官方有更新最新版本，如果想要安裝此教程版本可以把頁面翻到最下面，會列出所有歷史版本供用戶下載。

注意：ESP-IDF庫各版本之間API函數(shù)各有差異，版本號差別越大，差異越大，如果是新手小白還是盡量遵循你的開發(fā)板賣家或你找的源碼教程中的版本來。

?下載成功后，在安裝程序上單擊右鍵選擇 <以管理員身份運(yùn)行>打開程序。

?打開安裝程序后選擇簡體中文安裝

勾選我同意協(xié)議，單擊下一步按鈕。

?如果是第一次安裝，會出現(xiàn)如下提示。

安裝程序會檢查你當(dāng)前系統(tǒng)有沒有打開"長路徑支持"，因?yàn)镚NU編譯器產(chǎn)生的編譯文件會有非常深的目錄結(jié)構(gòu)，如果不支持長路徑，編譯可能出現(xiàn)文件不存在，目錄不存在等奇怪的錯(cuò)誤。這里單擊應(yīng)用修復(fù)按鈕，可以修復(fù)這個(gè)問題。

?在彈出的確認(rèn)對話框中，選擇是，開始修復(fù)

?修復(fù)完成，單擊下一步

安裝程序會提示修復(fù)成功；單擊下一步。

注意：如果修復(fù)不成功，一般情況是安裝軟件打開時(shí)沒有使用管理員權(quán)限打開，可以手動(dòng)修改注冊表來支持長路徑：打開注冊表HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\LongPathsEnabled 設(shè)置為 1。該操作需要管理員權(quán)限。

接下來一步，開始選擇安裝目錄，安裝程序默認(rèn)的安裝位置為?C:\Espressif，但這里我是安裝在F盤，如果全部源碼編譯后可能產(chǎn)生幾十G的大小占用，我的F盤空間很大，我在F盤創(chuàng)建了兩個(gè)文件夾，

一個(gè) <ESP32> 文件夾放IDF庫及后面學(xué)習(xí)用到的ADF，MDF等官方庫。

一個(gè) <ESP32_File> 文件夾放置所有的源碼工程。

注意：強(qiáng)烈建議安裝在其它盤符

原因1：有些電腦默認(rèn)C盤空間較小，ESP-IDF安裝后有幾個(gè)G大小

原因2：使用命令行工具操作配置源碼工程需要切換目錄，多一步操作，而且源碼工程編譯會生成大量文件，每個(gè)工程都會有一兩百M(fèi)B的占用空間。

?下一步，確認(rèn)安裝組件，這里全部打勾，默認(rèn)完全安裝時(shí)ESP32 C2是不打勾的，看需要自己選擇。然后單擊下一步

?再次確認(rèn)安裝目錄信息，然后單擊安裝。

?開始解壓離線安裝文件，靜靜等待它完成

?安裝完成。三個(gè)全部勾選，1、2用于測試環(huán)境安裝是否成功，3是將IDF工具鏈加入殺毒工具排除項(xiàng)，以加快編譯速度。

?單擊完成后出現(xiàn)如下兩個(gè)窗口，一個(gè)是PowerShell命令行，一個(gè)是傳統(tǒng)的cmd命令行窗口。顯示如下內(nèi)容，說明可以進(jìn)行工程編譯了。

二、檢查設(shè)置環(huán)境變量

安裝IDF庫完成后，雖然使用命令行的方式可以編譯工程了，但每次使用命令行著實(shí)不方便，這里檢查并創(chuàng)建兩個(gè)環(huán)境變量，為把ESP32編譯集成到VSCode中做準(zhǔn)備。

重要的一步，檢查你的系統(tǒng)環(huán)境變量，在用戶變量中檢查是否有 IDF_PATH和IDF_TOOLS_PATH這兩個(gè)環(huán)境變量，如果沒有的話，創(chuàng)建一下，注意你自己剛才安裝ESP-IDF庫的目錄。

打開電腦的用戶環(huán)境變量設(shè)置，計(jì)算機(jī)屬性->高級系統(tǒng)設(shè)置->環(huán)境變量->xx用戶環(huán)境變量：

IDF_PATH ： ESP-IDF庫的路徑

IDF_TOOLS_PATH ： ESP-IDF編譯工具鏈的路徑

檢查并創(chuàng)建這兩個(gè)用戶變量，像我的變量如下，你們參照剛才安裝ESP-IDF庫的目錄創(chuàng)建，確保目錄確實(shí)存在

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

IDF_TOOLS_PATH ： F:\ESP32\Espressif

?三、Visual Studio Code配置

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

Visual Studio Code編輯器在Windows上安裝比較簡單，直接setup.exe。一路下一步，安裝好后首次啟動(dòng)配置插件，插件配置必須聯(lián)網(wǎng)，從網(wǎng)上下載

設(shè)置中文

同時(shí)按Ctrl + Shift + X 快捷鍵
在左側(cè)“擴(kuò)展”視圖文本框中輸入“Language Packs”，找到Chinese 中文插件，單擊綠色的Install安裝按鈕，這里我們安裝的是中文簡體，安裝完成右下角彈出一個(gè)重啟按鈕，點(diǎn)擊重啟，語言自動(dòng)切換

?安裝C/C++擴(kuò)展

同樣的方式搜索C/C++，安裝C/C++擴(kuò)展來支持C語言代碼高亮

?打開ESP32工程

VSCode中打開ESP32的代碼工程，可以直接打開代碼所在的文件夾即可，文件菜單選擇打開文件夾，選擇一個(gè)源碼目錄打開

?打開后的文件結(jié)構(gòu)

?安裝Espressif IDF插件

在VSCode擴(kuò)展插件中搜索?Espressif IDF，單擊安裝按鈕

?安裝完成

?配置Espressif IDF插件

單擊VSCode設(shè)置齒輪菜單，彈出菜單選擇設(shè)置

在打開的設(shè)置頁面右上角單擊 <以JSON打開設(shè)置> 的一個(gè)按鈕

?將設(shè)置以JSON方式打開，上面的是我自己創(chuàng)建的一些設(shè)置，下面是Espressif IDF插件根據(jù)ESP環(huán)境變量自動(dòng)生成的一些配置，不用更改下面的，看自己情況更改上面的

?這里貼出我的完整配置：

{
	"editor.insertSpaces": false,				// 自動(dòng)插入空格禁用
	"editor.detectIndentation": false,			// 啟用時(shí)根據(jù)文件內(nèi)容進(jìn)行重寫
	"editor.renderControlCharacters": true, 	// 是否顯示控制字符：啟用
	"editor.renderWhitespace": "all",			// 顯示4個(gè)空格是....
	"editor.tabSize": 4,						// tab設(shè)置為4個(gè)空格
	"editor.fontSize": 18,						// 代碼字體大小
	"editor.fontFamily": "Monaco, 'Courier New', monospace", // 代碼字體
	"update.mode": "manual",					// 設(shè)置不自動(dòng)更新

	
	"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"
}

四、Espressif IDF插件使用

?依照上圖Espressif IDF插件基本菜單一共12個(gè)，常用的只有兩三個(gè)，依次為

1、選擇串口（插頭）：即連接開發(fā)板的下載串口號，VS會列出當(dāng)前連接電腦的所有串口讓你選擇，這個(gè)會記錄，再新打開VSCode不用重新選擇，開發(fā)過程中盡量不要更換USB線的電腦插口，否則串口號會變。

2、選擇目標(biāo)芯片：對應(yīng)idf命令idf.py set-target xxxx。即你當(dāng)前這個(gè)工程是要下載到什么芯片上面，如ESP32 S2,S3,C2,C3等等，工程要與芯片相匹配，這個(gè)選擇是寫入當(dāng)前工程配置的，一般不用更改，工程下配置文件基本已經(jīng)選擇好的。

3、選擇當(dāng)前工程目錄（文件夾）：也不用修改，一般打開工程時(shí)會默認(rèn)操作都在這個(gè)工程目錄下

4、工程配置菜單（齒輪）：對應(yīng)idf命令idf.py menuconifg，用來配置當(dāng)前工程的一些設(shè)置，配置項(xiàng)非常多，建議使用到再修改。一般代碼工程都是配置好的，且不用修改

5、清除工程（垃圾桶）：清除工程編譯文件，一般用于壓縮拷貝工程文件時(shí)用到，清除后工程目錄占用空間會占用非常小，KB級，編譯后為百M(fèi)B級，還有一些編譯過程中奇奇怪怪的問題也可以先清除編譯后再編譯

6、編譯工程（圓柱體）：編譯當(dāng)前工程，只是編譯，沒有下載功能

7、選擇下載模式（五角星）：一般都是選擇串口UART方式下載

8、下載（閃電）：下載編譯好的固件到設(shè)備芯片上，這里只是下載，沒有編譯功能，修改代碼后要先編譯再點(diǎn)這個(gè)下載，所做的修改才有效。

9、串口監(jiān)控（小電視）：打開與設(shè)備連接的串口，打印設(shè)備串口信息

10、編譯/下載/監(jiān)控（一團(tuán)火）：最常用的一個(gè)，它將編譯下載和打開串口監(jiān)控做在了一起，點(diǎn)一次全部搞定

11、打開命令行：打開命令行窗口，且會定位在當(dāng)前項(xiàng)目路徑下，可以執(zhí)行idf的一些命令

12、執(zhí)行自定義任務(wù)：不使用

五、頭文件包含、無法跳轉(zhuǎn)、波浪線問題解決

打開ESP32工程頭文件波浪線不能跳轉(zhuǎn)，并且提示“在browse.path中未找到包含文件”等等引用錯(cuò)誤提示

1、按前面的四步安裝配置好IDF插件后，刪除源碼目錄中 <.vscode>文件夾內(nèi)所有文件。

2、在VSCode中使用快捷鍵：Ctrl + Shift + P調(diào)出VSCode的命令面板，并輸入“添加vscode”

選擇“ESP-IDF:添加 vscode 配置文件夾”，VSCode 會自動(dòng)在源碼目錄下的<.vscode>文件夾中生成對應(yīng)的配置文件，對應(yīng)的紅色波浪線也消失了，按住Ctrl 鍵用鼠標(biāo)單擊你想查看的頭文件或函數(shù)，就可以跳轉(zhuǎn)了。

?文章來源地址http://www.zghlxwxcb.cn/news/detail-649330.html

到了這里，關(guān)于ESP32開發(fā)環(huán)境搭建Windows VSCode集成Espressif IDF插件ESP32_IDF_V5.0開發(fā)編譯環(huán)境搭建的文章就介紹完了。如果您還想了解更多內(nèi)容，請?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！