-i指定头文件路径优先级最高，编译时先于系统路径搜索，支持多路径按序匹配，双引号与尖括号均生效，但优先用于#include "xxx.h"查找。
用 -I 指定头文件路径，优先级最高
编译时加头文件路径最直接的方式就是 -I 选项。它告诉 clang（或 gcc）在系统默认路径之前，先去你指定的目录里找 #include "xxx.h" 或 #include <xxx.h></xxx.h>。
常见错误是把路径写错、漏掉 -I、或者和 -isystem 混用导致警告被抑制（比如你本想让自定义头文件报错，结果用了 -isystem 反而不报了）。
-
clang -I./include -I/usr/local/mylib/include main.c：多个-I按顺序搜索，前面的优先级更高 - 路径不能带空格；如果必须带，用引号包裹：
-I"/path/with space" -
-I对双引号和尖括号都生效，但优先用于双引号查找（即先查当前项目目录结构） - 避免写成
-I ./include（中间有空格）——clang 会把它当成两个独立参数，报错unknown argument
-isystem 和 -I 的区别在哪
-isystem 也加搜索路径，但它把对应目录标记为“系统头文件目录”，效果是：里面头文件里的警告（比如 deprecated 声明）默认被抑制，且在 #include <xxx.h></xxx.h> 查找中优先级略低于 -I、高于标准路径。
典型使用场景是引入第三方 SDK（如 LLVM 自己的头文件），你不想被它内部的 warning 干扰编译输出。
-
clang -I./myheaders -isystem /opt/llvm/include main.c：自己写的放-I，LLVM 头放-isystem - 误用
-isystem替代-I会导致你修改了头文件却没触发重新编译（因为构建系统可能不监控-isystem路径下的变化） - Clang 14+ 对
-isystem路径下头文件的宏定义检查更严格，若该路径含不完整头文件，可能引发macro redefined警告
环境变量 C_INCLUDE_PATH 和 CPLUS_INCLUDE_PATH 怎么用
这两个环境变量是编译器隐式读取的，相当于全局 -I，但只对 C 或 C++ 有效。适合统一配置 CI 环境或团队开发规范。
容易踩的坑是路径拼接出错，或变量被子 shell 覆盖。
-
export CPLUS_INCLUDE_PATH="/usr/local/llvm/include:$CPLUS_INCLUDE_PATH"：注意用:分隔，且要保留原值 - 在 Makefile 中写
$(shell echo $$CPLUS_INCLUDE_PATH)时，记得$要转义成$$ - 该变量不影响
clang -E -dM输出的宏列表顺序，仅影响查找行为 - 如果同时用了
-I和CPLUS_INCLUDE_PATH，-I仍优先
交叉编译时头文件路径特别容易错
用 -target aarch64-linux-gnu 这类三段式目标时，clang 不再默认用 /usr/include，而是去找目标平台的 sysroot 下的头文件。此时光加 -I 往往不够。
正确做法是配合 --sysroot 或显式指定目标头文件根目录。
clang --sysroot=/path/to/aarch64-sysroot -I/path/to/aarch64-sysroot/usr/include main.c- 更稳妥的是用预装好的工具链，比如
aarch64-linux-gnu-gcc -print-sysroot查路径，再套给 clang - 漏设
--sysroot时，即使-I指向了正确的头文件，也可能因缺失bits/types.h等底层依赖而报error: unknown type name '__u32' - LLVM 自带的
clang --target=...不自动推导 sysroot，这点和 GCC 不同，必须手动干预
-I 是最常用也最容易出错的一环——路径多一层、少一层斜杠，或者混用相对/绝对路径，在不同 shell 或 CI 环境下表现就不一样。交叉编译时更要盯紧 --sysroot 和真实头文件布局是否匹配。
