Homebrew安装指定LLVM版本推荐用brew install llvm@X（如llvm@15），自动处理依赖；需手动添加PATH，验证clang --version和llvm-config --version一致。
用 Homebrew 安装指定 LLVM 版本（推荐）
Homebrew 是 macOS 上最稳妥、依赖管理最干净的方式，能自动处理 libclang、liblldb 等动态库路径问题，避免手动配置时常见的 dyld: Library not loaded 错误。
LLVM 的旧版本在 Homebrew 中以 llvm@X 形式存在（如 llvm@15），但不是所有历史版本都长期保留在主仓库；较新的版本（如 19.0+）默认就是 llvm 包本身。
- 先查可用版本：
brew search llvm或访问 brew formula 页面 搜索具体版本号 - 安装 LLVM 15：
brew install llvm@15（会同时安装clang、lldb、llvm-config等） - 安装后不会自动加入
PATH，需手动添加：export PATH="/opt/homebrew/opt/llvm@15/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/opt/llvm@15/bin:$PATH"（Intel） - 验证：
clang --version应显示15.0.7类似字样；llvm-config --version也应匹配
用官方 tar.xz 安装指定版本（适合老旧系统或隔离需求）
当你用的是 macOS 10.13 或更老系统，Homebrew 可能已不支持，这时只能靠 LLVM 官方预编译包。但要注意：macOS 二进制包从 LLVM 19 开始才稳定提供 Intel + ARM 双架构支持，15–18 期间部分版本只有 ARM 包，老 Intel Mac 必须选带 x86_64-apple-darwin 后缀的包（如 clang+llvm-15.0.7-x86_64-apple-darwin21.0.tar.xz）。
- 下载后解压：
tar -xf clang+llvm-15.0.7-x86_64-apple-darwin21.0.tar.xz - 移动整个目录（不要只移
bin/）：sudo mv clang+llvm-15.0.7-x86_64-apple-darwin21.0 /usr/local/llvm-15 - 设置
PATH：export PATH="/usr/local/llvm-15/bin:$PATH"，并加到~/.zshrc（macOS Catalina 及之后默认 shell 是 zsh） -
关键一步：必须设置
DYLD_LIBRARY_PATH，否则lldb会因找不到liblldb崩溃：export DYLD_LIBRARY_PATH="/usr/local/llvm-15/lib:$DYLD_LIBRARY_PATH" - 注意：macOS 10.15+ 默认启用 SIP，
/usr/local下的 dylib 可能被限制加载，若仍报错，考虑改用~/local/llvm-15并相应调整路径
为什么 lldb 总是报 Library not loaded？
这是官方 tar.xz 包在 macOS 上最典型的失败现象，根本原因不是路径没加对，而是动态链接器找不到运行时依赖库——尤其是 liblldb 自身又依赖 libclang-cpp、libc++abi 等一堆同目录下的 dylib。
-
otool -L /usr/local/llvm-15/bin/lldb可查看它实际想找哪些库，路径是否为@rpath/xxx.dylib -
install_name_tool -add_rpath /usr/local/llvm-15/lib /usr/local/llvm-15/bin/lldb可硬编码 rpath（临时解法，不推荐长期用） - 真正可靠的解法只有两个：
DYLD_LIBRARY_PATH（开发调试用）或重装为 Homebrew 包（生产/日常用） - 别试图用
ln -s把 dylib 软链到/usr/lib—— SIP 会阻止，且污染系统
Clang 和 LLVM 版本号不一致怎么办？
LLVM 是项目名，Clang 是其子项目；它们共用主版本号，但发布节奏不完全同步。比如你装了 llvm@15，clang --version 显示 15.0.7 是正常的，而 llvm-config --version 显示 15.0.7 也应一致。但如果出现 clang 显示 15.0.0 而 llvm-config 是 15.0.7，说明你 PATH 混入了多个版本。
- 查清每个命令真实路径：
which clang、which llvm-config - 检查是否残留 Xcode 自带的
/usr/bin/clang（版本通常很老，如 14.x） - 用
clang -print-search-dirs看它实际找头文件和库的路径，确认是否指向你装的 LLVM 目录 - Mac 上最容易忽略的一点：VS Code 的 C++ 扩展默认读取
clang而非clang++，如果clang版本不对，clangd补全和诊断也会出错
15.0.2），得去 LLVM 官网的旧版归档页翻，而且大概率只有源码——那就得走 cmake 构建流程，那又是另一套变量和依赖逻辑了。 
