Clang编译动态库时必须显式用-I指定头文件路径，路径需与#include写法严格匹配；CMake中须用PUBLIC作用域导出头路径；-I仅影响编译期，与运行时动态库加载无关。
clang命令行编译动态库时，-I路径必须显式传入
Clang本身不自动推导头文件位置，#include "xlog.h" 能否找到，完全取决于你有没有用 -I 告诉它去哪找。漏掉 -I，哪怕头文件就在当前目录，也会报 xlog.h: No such file or directory。
常见错误现象：
-
clang -dynamiclib -o libxlog.dylib src/xlog.c—— 编译直接失败，因为没指定头文件路径 - 头文件在
include/xlog.h，却只写-Iinclude，但源码里写的是#include "xlog/xlog.h"，结果找不到
正确做法：
- 路径要和
#include写法严格匹配：如果头文件是include/xlog/xlog.h，就用-Iinclude，然后#include "xlog/xlog.h" - 多个头目录用多个
-I：例如-Iinclude -Ithird_party/spdlog/include -
-I必须放在源文件参数之后、-o之前，顺序错会导致被忽略
CMake中配置动态库的include路径，PUBLIC是关键
用 CMake 构建动态库时，target_include_directories 的作用域选错，下游项目照样找不到头文件——这不是编译问题，而是接口暴露问题。
典型错误：
- 写成
target_include_directories(xlog PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/include)：库自己能编译过，但别人#include "xlog.h"会失败 - 用全局
include_directories()：污染整个项目，不同子库头文件互相干扰
必须用 PUBLIC：
-
target_include_directories(xlog PUBLIC $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include> $<INSTALL_INTERFACE:include>)—— 同时支持构建期和安装后引用 - 如果头文件在
src/下，别硬塞进include/，直接target_include_directories(xlog PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}/src)更直白 - 验证是否生效：生成的
build/CMakeFiles/xlog.dir/flags.make里应出现-I/path/to/your/include
动态库头文件路径和运行时无关，别和-L/-rpath搞混
很多人看到程序运行时报 error while loading shared libraries，回头猛加 -I，这是方向性错误。-I 只影响编译期头文件查找，跟动态库加载完全无关。
Access global ocean tides model. Functions include tide height at a given date/time/location, tide extrema, and grid weather data.
下载
访问全球海洋潮汐模型。功能包括查询指定日期、时间和地点的潮高、潮汐极值及格点天气数据。
真正需要区分的三件事：
-
-I/path：告诉预处理器去哪找.h文件（编译阶段） -
-L/path -lxlog：告诉链接器去哪找libxlog.dylib（链接阶段） -
-Wl,-rpath,/path或LD_LIBRARY_PATH：告诉动态链接器运行时去哪加载.dylib（运行阶段）
一个常见陷阱：
- 头文件路径配对了，但动态库本身没放对地方，导致测试程序编译成功、运行失败；此时加再多
-I都没用 - macOS 上 dylib 的
install name默认是绝对路径，若不配合-Wl,-rpath或install_name_tool修改，-I再准也救不了运行时加载失败
iOS 或鸿蒙等受限平台，头文件路径要适配交叉编译工具链
在 iOS 或鸿蒙 PC 等交叉编译环境下，-I 路径不能只写本地路径，得指向目标平台的 sysroot 下对应头目录，否则即使路径存在，也会因架构不匹配而报错。
比如 iOS：
- 不能只写
-Iinclude，得补上 SDK 路径：-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk - 再配合
-Iinclude -I$SDKROOT/usr/include才能同时找到自定义头和系统头
鸿蒙 PC（musl）下更要注意：
- 交叉工具链的
sysroot通常带usr/include，-I必须指向该路径，而非本地/usr/include - 如果用了
clang --target=aarch64-linux-ohos，那所有-I路径都得是该 target 下可见的，本地 macOS 头文件路径无效
最稳妥的方式：先确认 clang -E -x c++ /dev/null -v 2>&1 | grep "search starts" 输出的实际 include 搜索路径，再决定你的 -I 往哪插。
