VSCode更新后编译报错：找不到Arduino自定义库头文件

一、让编译器识别自定义库路径的解决办法 #

• 检查VSCode Arduino扩展的库路径配置：打开VSCode设置（快捷键Ctrl+,），搜索Arduino: Library Path，确认已添加你的自定义库所在目录，多路径用英文逗号分隔。注意c_cpp_properties.json仅负责IntelliSense的语法提示，编译时的路径由扩展这个配置控制，更新VSCode可能重置了该设置。
• 调整库的存放位置：要么把自定义库放到Arduino默认库目录（比如Windows下的Documents\Arduino\libraries，Mac下的~/Documents/Arduino/libraries）；要么在你的项目根目录新建lib文件夹，把自定义库放在这里，VSCode Arduino扩展会自动识别该目录下的库。
• 清理编译缓存：点击VSCode左侧Arduino图标，找到Clean Build Folder选项执行，或者手动删除项目生成的build文件夹，避免旧缓存干扰路径识别。
• 重新选择板型配置：在VSCode右下角点击当前的Arduino板型（比如Uno），重新选择对应的板型并确认，更新VSCode后可能导致板型配置关联失效，影响库路径的加载。

二、Arduino编译流程指引 #

Arduino的编译本质是基于GCC工具链的封装，核心流程如下：

1. 文件收集：扫描项目主程序、引用的库，收集所有需要编译的.cpp、.h文件，处理#include指令的依赖关系。
2. 预处理：展开宏定义、替换头文件内容，生成预处理后的临时代码文件。
3. 编译：将每个源文件编译成独立的目标文件（.o），这一步会根据配置的库路径查找#include的头文件，找不到就会报致命错误。
4. 链接：把所有目标文件（项目代码、Arduino核心库、第三方库）链接成一个完整的可执行文件。
5. 格式转换：将可执行文件转换为目标开发板支持的二进制格式（比如.hex），用于后续上传。
   VSCode中的Arduino扩展是调用官方Arduino CLI来完成上述流程，因此编译时的路径规则由CLI或扩展配置决定，和IntelliSense的配置是相互独立的。

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