-i参数是解决“找不到头文件”问题的核心方法，其搜索顺序为源文件目录→-i路径（从左到右）→系统路径；#include "xxx.h" 并非仅查当前目录，若头文件在其他路径必须显式指定-i。
直接用 -I 参数加路径，别绕弯子。它不是可选项，是绝大多数“找不到头文件”问题的解法核心。
为什么 #include "xxx.h" 还报错？
常见错觉：只要写了双引号，编译器就该自动找到同目录下的头文件。实际不是——如果 xxx.h 不在当前源文件所在目录，而你又没告诉编译器去哪找，它照样失败。
-
#include "xxx.h"的搜索顺序：先查源文件所在目录 → 再查所有-I指定路径（从左到右）→ 最后查系统路径（如/usr/include） -
#include <xxx></xxx>完全跳过源文件所在目录，只走-I和系统路径 - 所以即使你用了双引号，若头文件放在
./inc/而源文件在./src/，不加-I./inc就必然报fatal error: xxx.h: No such file or directory
-I 参数怎么写才有效
它必须出现在 g++ 命令中，且位置不影响逻辑，但习惯放在源文件之前。多个路径按书写顺序决定优先级，前面的覆盖后面的同名头文件。
- 绝对路径：
g++ -I/home/user/project/include main.cpp - 相对路径（推荐）：
g++ -I../include -I./deps main.cpp - 路径里不能有空格；含空格要用引号包裹，但极不建议这么做
-
-I后面不能跟等号：-I=./include是错的，-I./include或-I ./include才对 - 重复加同一路径无害，但没必要；路径末尾加不加
/都行，-I./inc和-I./inc/等效
除了 -I，还有没有别的办法？
有，但不推荐日常使用：它们容易引发隐性问题，比如环境变量污染、项目间干扰或 CI 构建不一致。
-
CPLUS_INCLUDE_PATH环境变量：运行前执行export CPLUS_INCLUDE_PATH=$CPLUS_INCLUDE_PATH:/path/to/inc，之后所有g++命令都生效 —— 但只影响当前 shell，且容易和他人配置冲突 - CMake 中用
include_directories(./inc)或更现代的target_include_directories(mytarget PRIVATE ./inc)—— 这是工程级方案，适合多文件项目，但单文件编译时纯属杀鸡用牛刀 - 把头文件硬拷贝进
/usr/local/include—— 权限麻烦，升级系统可能被清掉，且违反封装原则
真正要注意的其实是路径顺序和 #include 写法的配合。很多人加了 -I 还失败，八成是因为写了 #include <myheader.h></myheader.h> 却指望它去当前目录找——这种细节不盯住，参数再多也白搭。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
