ESP-IDF：打开别人项目头文件包含报错（红色波浪线）

原创 已于 2026-03-04 20:33:57 修改 · 160 阅读 · 2 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
标签
#嵌入式硬件 #ESP
于 2026-03-02 11:46:55 首次发布

 红线的根因：IntelliSense 没有拿到 ESP-IDF 工程真实的编译参数（include 路径/宏/编译器）。

这个项目的 .vscode/settings.json 没有把 compileCommands 写进去

方法一：我们只需要在.vscode/settings.json里面加一句：

"C_Cpp.default.compileCommands": "${workspaceFolder}/build/compile_commands.json"

如下图

方法二：ctrl+shift+p，选择ESP-IDF:添加VS Code配置文件夹

Funing7
关注
VS Code+ESP-IDF开发避坑指南：头文件标红报错的5种解决方法（附CMakeLists.txt配置）
weixin_33670786的博客
04-01 484
本文详细解析了在VS Code中使用ESP-IDF开发ESP32时头文件标红报错的5种解决方法，包括环境配置检查、CMakeLists.txt规范配置、路径解析策略、缓存清理技巧和高级调试手段。特别提供了CMakeLists.txt的实战配置示例，帮助开发者彻底解决头文件路径问题，提升开发效率。
ESP32-VSCODE环境下添加组件，并解决头文件无法找到问题
tianya
09-27 1万+
ESP32入门
vscode使用compile_commands.json
yaq_30401的博客
06-07 4393
vscode+cmake可以实现C/C++项目开发和构建。提供信息，实现IntelliSense、代码补全、注释浏览、文件转跳等功能。Allow之后会在当前工作目录的。就能正常工作了，不用自己指定。
关于VS的esp-idf基本库和个人库关于头文件标红报错的解决方案
hexiaoze175的博客
02-12 3719
当初学者开始了解乐鑫的产品时常常关于开发环境感到头疼，这里讲一下初学者经常遇到的找不到头文件路径的问题。 这里我用一个乐鑫的示例工程作为演示。图比较多，请耐心浏览。 编译完成后就不报错了。 在实际过程中，我们要对工程进行模块化，所以就必须要学会创建添加自己的库。 首先 ，创建一个组件文件夹，名字是组件（components），其他名字应该也可以但是为了防止各种问题，就使用components。 之后在这个文件夹中添加 .txt 文件，名字命
vscode 开发ROS相关配置
reason的博客
05-20 1920
一、基础配置 1.ros 插件安装 Visual Studio Code Extension for ROS；通过Extensions搜索安装； 2.c_cpp_properties.json配置 ctrl+shift+p 打开command palette指令面板，找到C/C++:EditConfiurations(JSON),自动生成c_cpp_properties.json配置文件。 输出配置、编译命令文件： 依次执行以下命令，创建并初始化workspace； mkdir -p..
ESP IDF 引用头文件报错？暴躁！！！立马解决。
m0_58520840的博客
02-23 2009
ESP-IDF 引用头文件报错？暴躁！！！立马解决。
VScode debug ROS cpp程序设置 断点调试
ABC_ORANGE的博客
10-21 7028
说明 在vscode下面配置用于ROS项目开发的环境，通过vscode的debug可以断电调试程序，配置过程虽然有点繁琐但并不是特别复杂，需要更改地方并不是很多， 插件的安装： 　　通过vscode　左侧的EXTENSIONS　安装ros插件　ｃ++插件 生成c_cpp_properties.json文件，添加路径 　　当在cpp代码中的 #include <…> 这句话有下划线警示时...
ESP32的ESP-IDF在VScode工程下，头文件标红警告、报错、无法跳转
热门推荐
weixin_49337111的博客
12-23 2万+
在VScode环境中，通过ESP-IDF插件开发ESP32系列设备，但是工程代码中提示找不到头文件、相关的函数也无法跳转，这样不仅不美观，也一定程度上影响了开发效率，需要着手解决。
告别恼人波浪线：VSCode中ESP-IDF工程头文件路径精准配置指南
weixin_28834765的博客
03-05 357
本文针对VSCode开发ESP-IDF工程时头文件路径报错（红色波浪线）的常见问题，提供了精准配置指南。通过详细解析c_cpp_properties.json文件中的includePath与compilerPath核心参数，并给出可移植的配置模板与诊断方法，帮助开发者一劳永逸地解决IntelliSense失效问题，提升开发效率。
关于使用VScode+SDP_IDF编写代码时#include下有红色波浪线解决方法
weixin_46441288的博客
01-17 629
可以看到头文件全部存在报错现象，且无法跳转定义。鼠标靠近报错头文件跳出小灯泡，点击快速修复里的第一个跳转到C/C++扩展配置里，找到包含路径看到只有${workspaceFolder}/**这一条路径。你现在只填了，这只覆盖了项目自己的头文件，但没有包含 ESP-IDF 庞大的组件头文件，所以才会出现这类头文件找不到的情况。
VSCode搞ESP-IDF开发，头文件波浪线报错别慌！手把手教你配置C/C++插件的includePath
weixin_33704234的博客
04-04 192
本文详细介绍了在VSCode中配置ESP-IDF开发环境时解决头文件红色波浪线报错的方法。通过正确设置C/C++插件的includePath和compilerPath，动态配置环境变量路径，并提供多芯片支持、项目特定配置等高级技巧，帮助开发者彻底消除IntelliSense错误提示，提升ESP32开发效率。
ESP-IDF V5.x搭配VSCode，解决头文件波浪线的完整环境配置指南
weixin_30919429的博客
03-23 41
本文提供ESP-IDF V5.x与VSCode完美协作的完整环境配置指南，重点解决头文件波浪线问题。通过动态生成includePath、优化插件配置和高级技巧分享，帮助开发者构建无警告的高效开发环境，特别适合ESP32开发者提升工作效率。
VS Code中ESP-IDF项目头文件路径报错的快速修复指南
weixin_28840591的博客
03-04 247
本文针对VS Code中ESP-IDF项目常见的头文件路径报错问题，提供了一套从基础排查到进阶实战的完整修复指南。文章首先解释了VS Code智能提示报错与CMake实际编译的区别，随后详细介绍了通过配置c_cpp_properties.json、重新配置CMake以及使用ESP-IDF扩展命令等核心方法快速消除红色波浪线。重点阐述了如何通过正确创建和配置CMakeLists.txt文件来管理自定义组件及依赖关系，并分享了处理嵌套依赖、引入第三方库等进阶技巧与最佳实践，帮助开发者彻底解决路径问题，提升开发效
vscode第一次使用esp-idf时，遇到的报错说明
qq_73277579的博客
01-17 1266
若还有类似下面宏定义的错误提示，且已经包含了对应头文件，此时无需理他，直接build构建即可，或者在构建完在重新打开。vscode使用esp-idf插件时，若正确安装对应的版本，打开工程后如出现一下类似情况。可以按ctrl+shift+p，esp-idf add vsc ，执行这个命令。具体也可参考这篇文章，文章最后也是对应说明。
ESP32 在 Vscode中编译找不到对应文件或变量
woleigequ_ooi的博客
07-19 869
选择下图中C/C++:Edit Configurations。如下图所示，即可解决demo编译问题。按ctrl+shift+p。
ESP-IDF插件去除红色波浪线
qq_43862401的博客
08-11 1472
把这里的第一个文件夹删除，就是那个.vscode，接下来按ctrl+shift+P，输入vscode，如图，新装的ESP-IDF打开别人的工程有好多红色波浪线。选第一个，添加配置文件夹。
ESP-IDF示例工程报错解决
q2391566497的博客
03-29 851
如果是在有中文路径时是会生成失败的，在没有中文的路径中生成就可以正常构建烧录了。还有的方法就是直接构建，再重新打开文件，试过依旧不行。但是问题一节没有解决还是报错。
VS Code中ESP-IDF项目头文件路径配置与CMakeLists.txt优化指南
最新发布
weixin_42567046的博客
04-05 441
本文详细解析了在VS Code中配置ESP-IDF项目头文件路径与优化CMakeLists.txt的实用技巧。针对常见的头文件报错问题，提供了组件化配置方案、官方组件引用陷阱的解决方案，以及CMakeLists.txt高级优化策略，帮助开发者提升开发效率与项目可维护性。
ESP32学习笔记(1)--VS code ESP-IDF 开发环境搭建
小Young
07-11 1340
ESP32 VS code ESP-IDF 开发环境搭建
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值