vscode 下的 esp-idf 快速搭建指南（超详细） 头文件包含问题的解决

ESP-IDF 工具安装器

​ 安装 ESP-IDF 必备工具最简易的方式是下载一个 ESP-IDF 工具安装器。

​ 离线安装程序不需要任何网络连接。安装程序中包含了所有需要的依赖文件，包括 Git For Windows 安装器。是最简单不容易出错的安装方式,无需直接去下载配置依赖文件.

所需的依赖组件:

• 内置的 Python
• 交叉编译器
• OpenOCD
• CMake 和 Ninja 编译工具
• ESP-IDF

下载后,一直点击 next 后,大概记一下这里的后俩个地址,后面 vscode 的 esp-idf 插件配置需要用到:

python 环境的配置

在进行 vscode 插件配置之前,我们需要对 esp-idf 搭建 python,才能确保插件配置的成功,我们需要配置俩处的 python 环境.

第一处:(这里以我的安装环境为示例)

F:\Espressif\tools\idf-python\3.11.2\python.exe -m pip -V

查看环境是否配置成功,若没有输入命令:

F:\Espressif\tools\idf-python\3.11.2\python.exe -m ensurepip

以下为安装成功的示例:

第二处(同理):

第二处需要配置环境的地址是:

F:\Espressif\python_env\idf5.4_py3.11_env\Scripts\python.exe

vscode 的 esp-idf 插件配置

在 vscode 中按下 shift + ctrl + P 进入配置选项,选择配置 ESP-IDF Extension 选项进行配置

选择 ADVANCED 高级配置选项,下载版本选择本地系统上配置,下面俩个选项填的就是先前 ESP-IDF 工具安装器安装的那俩个地址.

如果再之前成功配置了 python 环境,才能进入下一步 ESP-IDF 的工具配置,这里我们选择本地的配置:

这一步完成就代表着 ESP-IDF 环境的在 vscode 上成功搭建起来了.

include 头文件的包含问题

如果工程中出现头文件的引入错误,删掉原来目录下的 .vscode 文件,按 F12,添加 VS Code 配置文件夹来程序配置生成 .vscode,就可以解决这个问题.