gcc未遵循-I指定的包含目录顺序 优先读取系统路径头文件问题

• 环境变量优先级高于命令行-I参数：C_INCLUDE_PATH（C语言）、CPATH（C/C++通用）等环境变量中指定的路径，搜索优先级会高于命令行传入的-I路径。你可以执行echo $C_INCLUDE_PATH $CPATH检查是否有预先配置的/home/apps/include相关路径。
• -isystem、-idirafter等特殊路径参数的干扰：如果编译参数中存在-isystem /home/apps/include这类参数，-isystem指定的系统头文件路径优先级会高于普通-I指定的路径，就算-I写在前面也会被覆盖。
• 路径为软链接导致的实际路径重合：检查你本地的../include路径是否是指向/home/apps/include的软链接，如果是，两个路径实际指向同一个位置，修改不生效是正常情况。可以执行ls -ld ../include确认路径属性。
• 大小写或路径拼写错误：Linux文件系统大小写敏感，检查本地../include下的目录是否是Records（首字母大写）、或者文件名拼写与records/novarec.h不一致，导致本地路径匹配失败，自动向后搜索到系统路径下的头文件。
• Makefile规则覆盖了编译参数：你贴出的编译命令如果不是实际执行的完整参数，很可能是Makefile中的隐式规则、或者CFLAGS/CPPFLAGS变量被后续逻辑修改，把/home/apps/include插入到了-I../include之前。可以执行make -n打印完整的实际执行命令，确认参数顺序。
• 头文件嵌套包含的间接引用：如果records/novarec.h本身还包含了其他头文件，嵌套的头文件如果也存在同名文件，搜索顺序规则依然适用，但这不会直接影响当前novarec.h的搜索路径，需要结合嵌套包含的写法判断。

你可以直接在编译参数中加入-H选项，执行编译时gcc会打印所有头文件的实际加载路径，直接就能确认novarec.h是从哪个目录加载的：

gcc -DLINUX64 -c -g -H -I. -I../include -I/home/apps/include -I/home/apps/include/em -I/home/apps/include/odbc -Wno-implicit-function-declaration -Wno-implicit-int -Wno-format-security -Wno-format-truncation -Wno-discarded-qualifiers novaget.c

如果需要查看完整的头文件搜索优先级排序，可以加上-v参数，gcc会输出所有搜索路径的先后顺序。

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