开题日期：2026.3.17
更新日期：2026.3.17

---

前言
ESP-IDF是以命令的形式来构建或者编译系统。

---

一、安装ESP - IDF

参考视频

1.下载ESP-IDF

网址：https://dl.espressif.cn/dl/esp-idf/

2.安装 ESP - IDF

我选用的是正点原子提供的：esp-idf-tools-setup-offline-5.4.exe

• 以管理员身份运行这个exe文件开始安装。
• 在安装过程中，如果你的电脑不支持长路径的画，会提示你应用修复，确认修复即可。
  

注意：安装路径一定不允许有中文。
安装完成后，桌面会出现下面两个图标：

3.设置 ESP - IDF 环境变量

在"此电脑"右击鼠标，选择"属性"，选择"高级系统设置"，选择"环境变量"，如下图所示

系统中已经存在一个名为"IDF_TOOLS_PATH"的环境变量
，还需要我们手动建立一个名为"IDF_PATH"的环境变量,值为:IDF的安装目录。我这里的目录为：C:\Espressif\frameworks\esp-idf-v5.4

---

二、VS code

参考视频（这个视频安装的是IDE）

1.安装VScode软件

2.VScode配置文件

可参考我的笔记：VS Code（Visual Studio Code）学习笔记中 二.使用技巧 2.配置文件。

3.安装扩展：C/C++ Extension Pack

4.安装扩展：ESP-IDF

---

这里重点注意，我刚开始就卡在这里了。
不要直接安装搜索到的ESP-IDF，需要安装特定版本的ESP-IDF。

安装1.10.2版本
安装完成后，会增加IDF的图标如下图：

5.添加ESP-IDF底层配置

1. EXPRESS（快速模式）
   扩展会自动下载最新版本的 ESP-IDF 和所有工具链
2. ADVANCED（高级模式）
   可选择下载新版本，或手动指定已有的工具路径
3. USE EXISTING SETUP（使用现有配置）
   或自动搜索系统中已有的 ESP-IDF 安装

三、验证 ESP-IDF 环境是否配置成功

1、启动ESP-IDF 5.4 CMD，查看信息

2、可运行以下命令快速检测：

python --version
git --version
cmake --version
ninja --version

正确应答如下图所示