Git子模块引入第三方库qmake编译时头文件包含报错如何解决

C/C++编译器对两种头文件引用语法的搜索规则存在明确区别：

• 用#include <xxx.h>尖括号形式引用的头文件，编译器仅会从编译参数-I指定的头文件搜索路径、系统默认头文件路径中查找，不会自动搜索当前被解析头文件所在的目录。
• 用#include "xxx.h"双引号形式引用的头文件，编译器会优先搜索当前被解析头文件所在的目录，再去上述全局搜索路径中查找。

你当前遇到的嵌套头文件找不到问题，核心原因是没有将NMEA2000库的源码所在目录正确添加到qmake的全局头文件搜索路径中：你手动写相对路径#include "../NMEA2000/src/NMEA2000_CAN.h"的方式，只能让编译器定位到你直接引入的第一层头文件；而库内部所有嵌套引用均使用尖括号写法，编译器不会顺着你写的相对路径到NMEA2000的src目录下查找同目录的其他头文件，自然会抛出文件不存在的错误。

手动修改子模块内的头文件把尖括号改成双引号的方式不可取：一方面会改动子模块源码，后续子模块版本更新、重新拉取时所有修改都会被覆盖，还会在子模块仓库中产生脏提交，违反Git子模块的使用规范；另一方面库内嵌套引用数量多，逐个修改的维护成本极高。

• 1. 替换你自身代码中所有带相对路径的库头文件引用，去掉路径前缀直接引用头文件名即可：

// 删掉原来的 #include "../NMEA2000/src/NMEA2000_CAN.h" 写法，替换为
#include <NMEA2000_CAN.h>

• 2. 打开项目的.pro配置文件，将NMEA2000库的src目录完整添加到全局头文件搜索路径中，推荐使用qmake内置变量$$PWD（指代当前.pro文件所在目录）拼接路径，避免相对路径层级错误：

# 路径根据你实际的子模块存放位置调整，示例为子模块目录与.pro文件同级的情况
INCLUDEPATH += $$PWD/NMEA2000/src

如果该库还有其他依赖的子目录（比如硬件适配层目录、扩展组件目录），也需要将对应目录一并追加到INCLUDEPATH配置中。

• 3. 配置修改完成后，必须先执行qmake操作重新生成Makefile，再执行编译。直接编译会沿用旧的Makefile配置，新增的头文件路径不会生效。

所有配置均在你自身项目的.pro文件中完成，不需要改动子模块内的任何源码，后续子模块版本升级、切换都不会受影响，也不会产生额外的提交冲突。

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