根本原因是cmake未找到llvmconfig.cmake文件，而非llvm未安装；该文件必须存在且路径正确，常见于缺失开发包、手动编译未启用安装配置或包管理器提供精简版。
为什么 find_package(LLVM) 总是报 Could NOT find LLVM
根本原因不是 LLVM 没装，而是 CMake 没在你预期的位置找到 LLVMConfig.cmake 或 llvm-config.cmake。这个文件必须存在，且路径要对得上——CMake 不会自动“猜”你在哪装的 LLVM。
常见现象包括：
- 系统用
apt install llvm装了，但只装了运行时和工具（llvm,clang），没装开发包（libllvm-dev或llvm-dev） - 手动编译安装 LLVM 后，忘了加
-DLLVM_INSTALL_TOOLCHAIN_ONLY=OFF，导致LLVMConfig.cmake没被安装到lib/cmake/llvm/下 - 用了包管理器（如 UOS/deepin 的
llvm-7deb 包），但安装的是精简版，压根不带 Config 文件
怎么确认 LLVMConfig.cmake 到底在不在、在哪
别靠猜，直接查文件系统：
CMake 4.3.2
下载
CMake 4.3.2 Windows x86_64 历史版本安装包，适合旧项目兼容、构建环境回退、CMakeLists.txt 迁移验证、Visual Studio/Ninja/Makefile 生成器测试和 C/C++ 项目维护。
- 运行
find /usr -name "LLVMConfig.cmake" 2>/dev/null（Linux）或find /opt/homebrew -name "LLVMConfig.cmake" 2>/dev/null（macOS Homebrew） - 如果什么都没输出，说明它确实不存在——哪怕
llvm-config --version能跑，CMake 也无从下手 - 如果找到了，比如路径是
/usr/lib/llvm-15/lib/cmake/llvm/LLVMConfig.cmake，那你就该把LLVM_DIR设为它的父目录：/usr/lib/llvm-15/lib/cmake/llvm，而不是/usr或/usr/lib/llvm-15 - 用
ls -l $(dirname $(dirname $(readlink -f $(which llvm-config)) ))/lib/cmake/llvm/LLVMConfig.cmake快速定位（适用于标准安装）
三种可靠解法：优先级从高到低
按实际场景选一种，别堆砌配置：
-
装完整开发包：Ubuntu/Debian 上跑
sudo apt install llvm-15-dev（版本号对齐你用的 llvm-config）；UOS/deepin 用户直接装官方提供的完整 deb 包，比如llvm-7_7.0.1-8_amd64.deb，它明确包含LLVMConfig.cmake -
手动指定
LLVM_DIR：cmake 命令里加-DLLVM_DIR=/path/to/llvm/lib/cmake/llvm，确保该路径下有LLVMConfig.cmake；注意大小写——find_package(LLVM)必须匹配文件名里的LLVM，不能写成llvm或Llvm -
退回到 Module 模式（不推荐但应急可用）：删掉
LLVM_DIR，自己写一个极简FindLLVM.cmake放进项目cmake/目录，里面只调find_program(LLVM_CONFIG_EXECUTABLE NAMES llvm-config)和execute_process解析输出，再设LLVM_INCLUDE_DIRS和LLVM_LIBRARIES；然后在CMakeLists.txt里加set(CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake" ${CMAKE_MODULE_PATH})
构建时仍失败？检查这几个硬坑
很多问题表面是找不到 Config，实则是更底层的链路断了：
- CMake 版本太低：
LLVMConfig.cmake通常要求 CMake ≥ 3.20，运行cmake --version确认；旧版即使文件存在也会静默跳过 - 权限问题：某些发行版（如 UOS）把
/usr/lib/llvm-*/lib/cmake/llvm/设为 root-only，普通用户 cmake 无法读取，得改目录权限或换sudo cmake（不推荐） - 交叉编译场景下，
llvm-config输出的路径可能是宿主机路径，而你的构建目标是 ARM 或 RISC-V，CMake 会因架构不匹配拒绝加载 Config —— 这时必须用FetchContent拉源码本地构建，绕过系统 LLVM
最常被忽略的一点：LLVM 的 Config 文件依赖 llvm-config 可执行文件本身存在且可调用。如果 llvm-config 在 PATH 里但权限被 strip 掉、或被 seccomp 限制（如某些容器环境），LLVMConfig.cmake 内部的 execute_process 就会失败，CMake 会直接放弃整个 Config 模式，转而报 “Could NOT find LLVM”。先跑一遍 llvm-config --cflags --libs 看是否真能工作，比反复改 LLVM_DIR 有用得多。
