clang报“cannot find include file”根本原因在于编辑器/语言服务器未获知头文件路径，需依赖compile_commands.json或c_cpp_properties.json配置；macos还需-isysroot指定sdk路径。
Clang 报 cannot find include file，基本不是代码写错了，而是它根本没看到你放头文件的地方。 编译器能跑通不代表编辑器或语言服务器能识别路径——这两套系统各自找头文件的方式完全不同。
为什么终端编译成功，但 VSCode/clangd 一直飘红？
clangd 和 VSCode 的 C/C++ 插件不读你的 CMakeLists.txt 或 Makefile，它们只认两样东西：compile_commands.json，或者手动写的 c_cpp_properties.json。如果你没生成前者，也没配后者，clangd 就只能靠猜，一猜就错。
- 运行
cmake成功 ≠ clangd 能定位头文件；它压根没加载构建配置 -
include_directories()在 CMake 里生效，但不会自动透传给 clangd - VSCode 不重启，旧的 clangd 进程会缓存过期的路径，改了配置也无效
- 用
#include "xxx.h"时，clangd 优先查当前文件所在目录，再查你配置的路径；而#include <xxx.h></xxx.h>直接跳过当前目录
必须生成 compile_commands.json（CMake 用户）
这是最可靠、最推荐的方式。clangd 唯一信任的路径来源就是这个 JSON 文件。
Access global ocean tides model. Functions include tide height at a given date/time/location, tide extrema, and grid weather data.
下载
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
- 在
CMakeLists.txt最顶部加一行：set(CMAKE_EXPORT_COMPILE_COMMANDS ON) - 删掉整个
build/目录，重新运行cmake -B build -G Ninja（或你用的生成器） - 检查
build/compile_commands.json是否存在，且里面每个条目都有-I/path/to/include字段 - VSCode 中按
Ctrl+Shift+P→ 输入Clangd: Restart language server，或直接关掉再重开窗口
clang-tidy 或命令行 clang 报找不到头文件？补 -I 和 -x
clang-tidy 默认当 C 用，遇到 C++ 头文件（比如 iostream）会直接失败，必须显式声明语言和路径。
- 加
-- -x c++：告诉 clang-tidy 后面参数是给 clang 的，且语言是 C++ - 加
-I /path/to/your/include：指定本地头文件根目录，可多次使用叠加多个路径 - 完整命令示例：
clang-tidy main.cpp --checks='*' -- -x c++ -I ./include -I /usr/include/c++/12 - 注意：
--是分隔符，前面是 clang-tidy 参数，后面才是传给 clang 的编译参数
macOS 上连 iostream 都找不到？SDK 路径断了
从 macOS Mojave 开始，系统头文件全收进 SDK，Clang 必须通过 -isysroot 才能访问。Homebrew 安装的 LLVM 默认不带这个参数。
- 用系统自带 Clang：运行
sudo xcode-select --switch /Library/Developer/CommandLineTools，然后卸载 brew 的 llvm - 必须用 brew 的 llvm（比如要 OpenMP）：编译时加
-isysroot $(xcrun --show-sdk-path) - VSCode 中，在
c_cpp_properties.json的compilerPath对应配置块里，加上"intelliSenseMode": "clang-x64"和"cStandard": "c17"、"cppStandard": "c++20"，避免 IntelliSense 自作主张切错模式
最容易被忽略的一点：路径拼写对大小写敏感，Include 和 include 在 macOS/Linux 下就是两个目录；另外，target_include_directories() 的作用域只对指定 target 生效，别漏写 target 名字——写成 target_include_directories(myapp PRIVATE ${CMAKE_SOURCE_DIR}/include)，而不是笼统地全局配置。
