提示：
本文檔為 ESP32 教程系列，旨在為客戶進行 ESP32 系列芯片開 發提供環境搭建、工程示例演示等方面的參考文檔及視頻演示，降低 ESP32 系列芯片、模組開發的入門難度。

ESP32 教程系列文檔主要參考于樂鑫官網提供的 ESP32 入門教 程：https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/index.html。

---

1、 工具鏈設置

1.1 安裝 git

1.1.1.

git 下載地址：https://git-scm.com/downloads

1.1.2 安裝

（1）下載

（2）設置安裝路徑

（3）一直NEXT，直至完成安裝

1.2 安裝python（版本3.8以上，建議3.8）

1.2.1 下載

python下載地址：https://www.python.org/downloads/

1.2.2 安裝

（1）下載

（2）安裝



1.3 獲取ESP-IDF

方式一：在文件夾下打開git，使用下方命令下載esp-idf（下載的esp-idf位置在當前文件夾）：

git clone -b release/v4.3 --recursive https://github.com.cnpmjs.org/espressif/esp-idf.git

（注：-b release/v4.3表示當前下載版本為release/4.3,需要下載其它版本或版本介紹請移至樂鑫官網查看具體介紹

出現如下錯誤：

進入esp-idf目錄下執行：git submodule update --init --recursive

方式二：前往樂鑫官網下載esp-idf壓縮包，解壓后改名為esp-idf,下載地址：
https://www.espressif.com/zh-hans/support/download/sdks-demos?keys=&field_type_tid%5B%5D=13

1.4 安裝ESP-IDF工具安裝器（版本2.5）

1.4.1 下載

ESP-IDF工具安裝器下載地址：https://dl.espressif.com/dl/esp-idf/?idf=4.4

1.4.2 安裝

（1）下載


（2）自動檢測的git路徑

（3）選擇自己下載的esp-idf

（4）選擇安裝路徑

（5）使用Espressif作為下載服務器

（6）選擇創建快捷方式

（7）完成安裝

---

2、運行hello_world示例

2.1 克隆工程

使用命令克隆hello_world工程:

xcopy /e /i %IDF_PATH%\examples\get-started\hello_world hello_world

2.2 工程配置

進入hello_world示例，進行工程配置：

cd hello_world

idf.py set-target esp32 (使用其它芯片請選擇對應芯片類型，如：esp32c3)

(打開一個新項目后，應首先設置“目標”芯片 idf.py set-target esp32。

注意：此操作將清除并初始化項目之 前的編譯和配置（如有）。 您也可以直接將“目標”配置為環境變量（此時可跳過該步驟）)

idf.py menuconfig

如果之前的步驟都正確，則會顯示下面的菜單：

您可以通過此菜單設置項目的具體變量，包括 Wi-Fi 網絡名稱、密碼和處理器速度等. hello_world 示例項目 會以默認配置運行，因此可以跳過使用 menuconfig 進行項目配置這一步驟。

2.3 編譯工程

idf.py build

2.4 硬件連接

用USB線將ESP32模組與電腦連接

2.5 查看端口

在開始菜單中選擇設備管理器查看當前端口號：

2.6 工程燒錄

進行燒錄：

idf.py -p COM21 flash

燒錄成功！

2.7 監視工程

查看監視器：

idf.py -p COM21 monitor

成功打印hello_world.

---

3、VS Code的使用

3.1 VS Code的下載與安裝

3.1.1 下載VS Code

官網下載地址：https://code.visualstudio.com/Download#

3.1.2 安裝VS Code

勾選這兩項可將VS Code添加至右鍵菜單

3.2 VS Code的使用

3.2.1 移植腳本

（1）創建一個文本文檔，將下列內容復制粘貼（需適當修改）

@echo off
Set home=%cd%
cd D:\ESP_IDF\esp-idf

C:\Windows\system32\cmd.exe /k
““D:\ESP_IDF\esp-idf-tool.espressif\idf_cmd_init.bat”
“D:\ESP_IDF\esp-idf-tool.espressif\python_env\idf_py3.8_env\Scripts”
“D:\ESP_IDF\Git\Git\cmd””

/*
home 為儲存當前路徑的變量名，可改可不改。
cd 后的路徑為esp-idf路徑

C:\Windows\s… 這一句指令替換為ESP-IDF Command Prompt (cmd.exe)的目標

右鍵點擊ESP-IDF Command Prompt (cmd.exe)，選擇屬性，將目標中語句進行復制替換。

完成后將文檔改名為get_idf.bat,將其放入ESP-IDF Command Prompt (cmd.exe)所在位置。

*/

（2）創建另一個文本文檔，復制粘貼以下內容：

@echo off
cd %home%

/* home 變量應與第一個腳本保持一致 */

將文檔改名為go_home.bat,將其放入ESP-IDF Command Prompt (cmd.exe)所在位置。

3.2.2 運行hello_world示例

(1)使用VS Code打開hello_world工程文件夾,打開一個新終端，運行get_idf:

(2)運行go_home,返回hello_world目錄下：

（3）工程編譯

（4）工程燒錄與監視


成功打印hello_world.

---

注意事項

4.1 注意事項

（1）git版本沒有具體要求

（2）python版本建議為3.8（至少在3.8之上），因為esp-idf工具所使用的python版本似乎為3.8

（3）ESP-IDF工具安裝器的版本建議使用2.5，雖然已經更新到2.9，但新版本總會在最后安裝時出現一些錯誤（也有可能是我網絡問題）

（4）腳本移植時要進行相應的替換，命令間的空格最好重新設置，防止因字符格式的轉變而插入其它字符

---

相關建議

本文檔使用ESP-IDF工具安裝器的方式在Windows下構建esp-idf環境，同時為了更方便于編寫代碼而通過移植腳本的方式引入VS Code的使用，將代碼編寫與編譯一體化，消除頻繁切換界面的麻煩，該方式適用于習慣在Windows環境下使用命令行進行開發的開發者。

---

啟明云端

深圳市啟明云端科技有限公司（簡稱“啟明云端”）是國內領先的物聯網通訊產品和整體解決方案提供商，為全球企業客戶提供無線通訊產品及場景智能化服務。

公司作為Espressif（樂鑫科技）大中華區合作伙伴，Sigmastar（晨星）A級方案商；得天獨厚的上游芯片廠商資源及嚴格的質量控制體系為公司發展提供強大的實力保證，總能在第一時間為客戶帶來極具競爭力的產品。

公司主要提供物聯網無線通訊芯片、模組、人機界面（HMI）、人工智能及工業控制嵌入式產品等，方案已服務全球超過1000+企業，特別是在智能家電、智能家居、智慧工業、醫療、農業監測等領域積累了豐富的產品和項目經驗。

總結

以上是生活随笔為你收集整理的乐鑫代理启明云端分享|ESP32 系列教程之四： Windows 搭建 esp-idf 环境的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。