根本原因是未显式告知clang头文件路径，必须用-i参数指定；例如项目含./src/main.cpp和./include/utils.h时，应执行clang++ -i./include -std=c++17 src/main.cpp -o main。
Clang 编译时找不到 include/ 下的头文件，根本原因不是 Clang 本身限制，而是你没告诉它去哪找——必须显式传入 -I 参数或通过构建系统注入路径。
Clang 命令行里怎么加 include 目录
直接调用 clang++ 时，-I 是唯一可靠方式。路径可以是相对或绝对，但注意顺序：靠前的 -I 优先级更高，会覆盖后面同名头文件。
- 项目结构为
./src/main.cpp和./include/utils.h，则编译命令应为：clang++ -I./include -std=c++17 src/main.cpp -o main - 若
include在上层（如../include），路径必须写对，clang++不会自动向上递归查找 - 多个目录用多个
-I：例如-I./include -I./third_party/spdlog/include，不要合并成一个参数 - 避免使用
-I.—— 这会让当前目录变成系统头搜索路径，可能意外屏蔽标准库头文件（如iostream）
CMakeLists.txt 中怎么让 Clang 用上 include 目录
include_directories() 是最常用方式，但它只影响当前 CMakeLists.txt 及其子目录下的 target；更推荐用 target_include_directories()，作用域明确、支持 PRIVATE/PUBLIC/INTERFACE 控制。
Access global ocean tides model. Functions include tide height at a given date/time/location, tide extrema, and grid weather data.
下载
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
- 老写法（仍可用但不推荐）：
include_directories(${CMAKE_CURRENT_LIST_DIR}/include) - 新写法（推荐）：
target_include_directories(your_target PRIVATE ${CMAKE_CURRENT_LIST_DIR}/include) - 如果头文件要被依赖它的 target 使用（比如库 A 的头暴露给库 B），用
PUBLIC或INTERFACE -
${CMAKE_CURRENT_LIST_DIR}比.更安全，避免因cd到别处导致路径错乱
VS Code + clangd 插件为啥还是报红线
clangd 不读 CMake 缓存，也不解析 include_directories()，它只认自己配置的编译参数。即使 CMake 能编译成功，clangd 也可能完全不知道 include/ 在哪。
- 首选方案：在项目根目录建
.clangd文件，内容为：CompileFlags:<br> Add: ["-I./include", "-I./third_party/include"]
- 备选方案：改
.vscode/settings.json，加："clangd.arguments": ["-I./include"] - 绝对路径慎用：比如
-I/home/user/project/include，换机器就失效；相对路径-I./include更便携 - 注意：这些配置只影响 clangd 的语义分析，和实际编译无关——编译仍由 CMake 或命令行控制
为什么有时候加了 -I 还报错：'xxx.h' file not found
常见陷阱不在路径本身，而在头文件引用方式与路径结构不匹配。
- 如果
include/utils/math.h，而你在代码里写#include "math.h"，那-I./include就不够——得写#include "utils/math.h"或加-I./include/utils - Windows 下路径分隔符不影响
-I（-I.\include和-I./include都行），但 MSVC 风格的/I参数在 Clang 下无效 - Clang 对引号敏感：
#include <xxx></xxx>查找系统路径，#include "xxx"先查用户路径（即-I指定的），再查系统路径 - 检查是否拼错路径：比如
-I./incldue（少个l），这种错误不会报 warning，只会静默失败
最易被忽略的一点：CMake 生成的 Ninja/Makefile 里实际用的 -I 参数，和你手动写的不一定一致——建议运行 cmake --build build --verbose 看真实命令行，比猜更可靠。
