结论：90%不是代码错误，而是Clang未正确配置SDK或sysroot路径——macOS需-isysroot指向Xcode SDK，Linux缺libc6-dev等开发包，Windows需--target指定工具链，交叉编译必须显式传--sysroot。
直接说结论：LLVM 编译时提示头文件不存在，90% 不是代码写错了，而是 clang 没找到它该用的 SDK 头文件路径，或者你误用了非系统默认工具链（比如硬上 GCC、交叉编译没配 --sysroot、或在 macOS 上手动塞 /usr/include）。
Clang 找不到 stdio.h 等标准头文件（macOS 常见）
这是 macOS 下最典型的“假缺失”——stdio.h 看似找不到，实则是 Xcode Command Line Tools 没装、路径损坏，或 Clang 被误导去查已移除的 /usr/include。
- 先运行
xcode-select --install；如果报invalid active developer path，立刻执行sudo xcode-select --reset再重试 - 验证安装是否生效：
ls /Library/Developer/CommandLineTools/usr/include/stdio.h应该能输出路径 - 别在编译命令里加
-I/usr/include—— macOS 10.14+ 已删掉这个目录，Clang 默认走 SDK 路径（如/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include），强行指定反而覆盖正确路径 - VS Code 报
stdio.h找不到？点右下角 C/C++ → “Edit Configurations (UI)” → 把Compiler path设为/usr/bin/clang，不是gcc或clang++
LLVM Pass 编译时报错找不到 LLVM 头文件（如 LLVMCore.h）
这类错误常出现在自定义 Pass 的 CMakeLists.txt 配置不全时，不是头文件真丢了，而是 CMake 没告诉编译器“去哪找 LLVM 的 include 目录”。
- 确保
find_package(LLVM REQUIRED CONFIG)成功，并在include_directories(${LLVM_INCLUDE_DIRS})或现代写法target_include_directories(your_pass PRIVATE ${LLVM_INCLUDE_DIRS})中显式引入 - 检查
llvm_map_components_to_libnames是否调用，且传入的组件名匹配你实际用到的模块（例如用了LoopInfo就得包含LLVMScalarOpts，而不是旧名LLVMAnalysis） - 如果用
add_subdirectory(llvm)方式集成，确认子项目llvm-config可执行且版本一致；混用不同 LLVM 版本的头文件和库会导致符号找不到或类型不匹配
交叉编译时提示 bits/libc-header-start.h 等 glibc 头文件缺失
这说明 Clang 正在为目标平台（如 RISC-V、ARM）编译，但没被告知去哪里找目标系统的 C 库头文件，--sysroot 缺失或路径不对是最常见原因。
- 编译命令中必须显式加上
--sysroot=/path/to/riscv-sysroot（或对应架构路径），且该路径下要有usr/include/bits/libc-header-start.h - 不要指望 Clang 自动猜 sysroot；即使你设置了
LLVM_SYSROOT环境变量，Clang 也不会自动读取，必须通过命令行参数传入 - 检查 sysroot 是否真的包含完整头文件：运行
find /path/to/sysroot -name "libc-header-start.h"；如果找不到，说明riscv-gnu-toolchain构建时没成功安装 glibc 头文件，需重新带--enable-multilib和--with-newlib（或--with-system-libraries）参数构建 - 避免用
brew install riscv-gnu-toolchain这类二进制包——它们常省略头文件或 sysroot 结构不全，推荐从源码构建
Linux 上编译第三方库提示 drm.h、harfbuzz.h 等缺失
这类头文件属于系统级开发包，不是 LLVM 自带的，缺的是发行版提供的 -dev 或 -devel 包，而非编译器本身问题。
- 先查文件是否真在系统里：
find /usr -name "drm.h" 2>/dev/null；如果没结果，就不是路径问题，是包根本没装 - Ubuntu/Debian：装
libdrm-dev、libharfbuzz-dev；CentOS/RHEL：装libdrm-devel、harfbuzz-devel - 若头文件在非标路径（如
/opt/homebrew/include/harfbuzz/hb.h），编译时加-I/opt/homebrew/include，而不是改代码里的#include <harfbuzz/hb.h> - R/Python 包编译失败提示
numpy/arrayobject.h找不到？先确保pip install --force-reinstall --no-binary=numpy numpy，再确认 NumPy 的get_include()返回路径已被加入编译选项
最容易被忽略的一点：Clang 的头文件搜索路径和 GCC 不完全兼容，尤其在交叉编译或自定义 sysroot 场景下，-v 参数比猜更管用——运行 clang --target=riscv64-unknown-elf -x c -E -v /dev/null 2>&1 | grep "search starts"，能直接看到它实际查了哪些路径。别跳过这步，很多“找不到”问题，一眼就能定位到漏了哪一层路径。
