-include 直接在所有源文件开头插入指定头文件内容，不走搜索路径，失败报“no such file”，适用于统一注入宏或声明；它不参与头文件守卫去重，且不能带路径。
-include 会跳过头文件搜索路径，直接插入预处理阶段
-include 不是让编译器“找”某个头文件，而是强制在所有源文件最开头插入一段预处理指令，效果等价于在每个 .c 文件第一行手动写 #include "xxx.h"。它不走 -I 或系统路径查找逻辑，也不检查文件是否存在——如果指定的头文件不存在，错误发生在预处理阶段，报错信息是 fatal error: xxx.h: No such file or directory，而不是“找不到头文件”的模糊提示。
典型用法是统一注入配置宏或公共声明，比如：
gcc -include config.h main.c util.c -o program
这会让 config.h 的内容出现在 main.c 和 util.c 的最顶部（甚至在 #include <stdio.h></stdio.h> 之前），所以它能影响后续所有头文件的行为（比如提前定义 _GNU_SOURCE）。
-include 和 #include "xxx.h" 的行为差异
二者表面都是包含头文件，但机制完全不同：
-
#include "xxx.h"：按搜索顺序找文件（当前目录 →-I路径 → 系统路径），失败时明确提示“not found”，且只作用于当前源文件 -
-include xxx.h：不查路径，直接尝试打开xxx.h（相对路径以当前工作目录为基准），失败时报No such file or directory；一旦成功，对命令行里所有源文件生效 - 如果
xxx.h里有#pragma once或#ifndef守卫，-include仍会触发一次包含——它不参与头文件守卫的去重逻辑，只是机械插入
常见误用和坑点
很多人想用 -include 替代 -I 解决头文件路径问题，这是错的：
-
-include /path/to/header.h不合法 ——-include后面只能跟文件名，不能带路径；路径必须靠cd切到对应目录，或把头文件软链接进当前目录 - 和
-D混用时注意顺序：-DFOO=1 -include config.h中，config.h里若用了FOO，能正常展开；但反过来-include config.h -DFOO=1，则config.h读取时FOO还未定义 - 在 Makefile 中使用时，别漏掉引号：
CFLAGS += -include "config.h"，否则 shell 可能因空格或特殊字符截断参数
替代方案：什么时候该用 -iquote 或 -isystem
如果你真正想解决的是“让某个头文件优先被 #include <xxx></xxx> 找到”，-include 不是正解。应该用：
-
-iquote /path/to/headers：专用于#include "xxx.h"，搜索优先级高于-I，但低于当前目录 -
-isystem /path/to/headers：用于#include <xxx.h></xxx.h>，优先级高于系统路径但低于-I，且其中头文件的警告会被抑制 - 而
-I对双引号和尖括号都生效，是最常用也最直白的选择
真正需要 -include 的场景其实很窄：统一注入宏定义、跨文件共享类型声明、或 patch 第三方代码时不改源码——它不是路径管理工具，而是预处理层面的“全局注入开关”。
