Arduino IDE 2.0.3引入自定义头文件提示找不到的解决方法

可行解决方案 #

• 修正头文件引用语法：将代码中的#include <classfile.h>替换为#include "classfile.h"。C/C++语法中，<>用于搜索系统或Arduino库目录的头文件，而""会优先搜索当前草图所在的目录，更适合自定义本地头文件。
• 规范草图文件结构：
  • 要么保证classfile.h和project.ino在同一目录层级；
  • 要么在草图目录下新建src子文件夹，将头文件放入其中，然后使用#include "src/classfile.h"引用。
• 重新通过IDE打开草图：关闭当前IDE窗口，通过「文件」→「打开」选择project.ino启动草图，避免直接双击.ino文件导致IDE识别的临时编译目录异常。
• 检查文件名合法性：
  • 确保文件名无中文、空格或特殊字符；
  • 在Windows文件夹选项中开启「显示文件扩展名」，确认文件实际后缀是.h而非隐藏的.h.txt。
• 重置IDE索引缓存：打开IDE的「首选项」，找到「更多选项」中的「重置索引」功能，执行后重启IDE再尝试编译。

问题原因说明 #

Arduino IDE 2.x在编译时会将草图文件复制到系统临时目录进行处理，如果自定义头文件不在IDE默认识别的范围内（同草图目录或src子目录），就不会被同步到临时目录，导致编译阶段找不到文件。同时，尖括号的头文件搜索路径不包含当前草图目录，这也是双引号引用更有效的原因。

内容的提问来源于stack exchange，提问作者PLSeuJ