编译阶段用-i指定头文件路径，链接阶段用-l和-l配置库文件；-i只影响头文件查找，-l只指定库路径，-l指定库名且必须在对应-l之后；cmake中应通过target_include_directories和target_link_libraries作用于目标，而非全局设置。
编译阶段用 -I 指定头文件路径，链接阶段用 -L 和 -l 配置库文件
Clang 编译多个 .cpp 文件时，“找不到头文件”和“undefined reference”是两类独立问题，必须分阶段处理。头文件路径错，clang++ 在预处理/编译阶段就报错；库路径或库名错，要到链接阶段才暴露。
-
-I /path/to/include：只影响头文件查找（#include），不参与链接 -
-L /path/to/lib：只告诉链接器去哪找库文件，本身不链接任何库 -
-lfoo：告诉链接器链接名为libfoo.a或libfoo.so的库，必须配合-L才能生效 - 顺序很重要：
-L必须出现在对应-l之前，否则链接器忽略该路径
CMake 中正确设置库路径的三种方式
直接在命令行拼 -I/-L/-l 容易出错且不可复用，CMake 提供更健壮的抽象。关键不是“怎么加”，而是“加给谁”——目标（target）才是作用域边界。
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- 用
target_include_directories(my_target PRIVATE /path/to/include)：仅该 target 能看到头文件，推荐替代全局include_directories() - 用
target_link_libraries(my_target PRIVATE foo)：自动查找libfoo，前提是已通过find_library()或add_subdirectory()注册过 - 若库不在标准路径，先
find_library(FOO_LIB NAMES foo PATHS /opt/mylib/lib)，再target_link_libraries(my_target ${FOO_LIB})，避免硬编码路径
compile_commands.json 里路径没生效？检查它是否被 clangd 或 clang-uml 正确加载
很多工具（如 clangd 补全、clang-uml 生成图）依赖 compile_commands.json 里的完整编译命令，但该文件中的 -I 和 -L 不会自动被所有工具消费。clangd 默认只读 -I，完全忽略 -L 和 -l；clang-uml 则可能因路径解析基准不同而找不到文件。
- 确认
compile_commands.json真实存在且路径正确：它必须位于项目根目录，或通过--compilation-database-dir显式指定 - clangd 不处理
-L：链接问题不会影响补全，但如果你在代码里用了dlopen()或手动extern "C"声明，需额外在.clangd里用CompileFlags: Add: [-I...]补充 - clang-uml 对相对路径敏感：它默认以配置文件位置为基准解析路径，若用
--paths-relative-to-pwd，则需确保当前工作目录与compile_commands.json中记录的源文件路径一致
Android NDK 场景下特别注意 sysroot 和架构路径嵌套
用 Clang 编译 Android 代码时，NDK 提供的头文件和库不是平铺的，而是按 ABI（如 arm64-v8a）和 API level 分层。直接加 -I 到顶层目录会失败，因为 sysroot/usr/include 下没有 android/api-level 子目录。
- 正确做法是让 Clang 自动推导：传
--sysroot=/path/to/ndk/toolchains/llvm/prebuilt/linux-x86_64/sysroot，它会自动在sysroot/usr/include和sysroot/usr/include/c++/v1等路径查找 - 若必须手动加
-I，路径应具体到 ABI+API 组合，例如-I/path/to/ndk/platforms/android-29/arch-arm64/usr/include - NDK 的
lib目录结构更复杂：/path/to/ndk/sources/cxx-stl/llvm-libc++/libs/arm64-v8a/libc++_shared.so，不能只写-L /path/to/ndk/sources/cxx-stl/llvm-libc++/libs，必须精确到 ABI 子目录
compile_commands.json 里的 -I，也不看 CMake 中未关联到 target 的 link_directories()。一切必须落到具体的 target_link_libraries() 调用上，且库名要与文件名严格匹配（去掉 lib 前缀和扩展名）。**
