brew install llvm 会安装完整 llvm 工具链，包括 clang、clang++、llc、opt、llvm-dis、llvm-config、lld、lldb 等，但不包含系统头文件或 macos sdk；它不会自动覆盖系统默认编译器，需手动调整 path 才能使 clang --version 显示 homebrew 版本。
brew install llvm 会装什么
执行 brew install llvm 后，Homebrew 会安装完整 LLVM 工具链，包括：clang、clang++、llc、opt、llvm-dis、llvm-config、lld（链接器）、lldb（调试器）等。它**不包含**系统级头文件（如 /usr/include）或 macOS SDK，这些仍需通过 Xcode Command Line Tools 提供。
常见误区是以为装完就能直接用 clang 替代系统默认编译器——实际不会自动覆盖。macOS 自带的 /usr/bin/clang 仍优先被调用，除非你显式调整 PATH 或使用全路径。
装完后 clang --version 还是老版本？
这是最常遇到的问题：运行 clang --version 显示 Apple Clang（比如 15.x），而非 Homebrew 安装的 LLVM Clang（比如 19.x）。根本原因是 shell 查找命令时按 PATH 顺序匹配，而 /usr/bin 在 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）之前。
- 检查 Homebrew 的 bin 路径是否在
PATH前置位：运行echo $PATH，确认/opt/homebrew/bin（M1/M2/M3）或/usr/local/bin（Intel）出现在/usr/bin之前 - 若不在，编辑
~/.zshrc（macOS Catalina 及以后默认 shell），添加：export PATH="/opt/homebrew/bin:$PATH"（Apple Silicon）或export PATH="/usr/local/bin:$PATH"（Intel） - 重载配置：
source ~/.zshrc，再验证：which clang应输出/opt/homebrew/bin/clang - 不建议用
sudo ln -s强行覆盖/usr/bin/clang：可能破坏 Xcode 工具链，且每次系统更新都可能被重置
llvm-config --version 和 clang --version 不一致？
有时 clang --version 显示 LLVM 19.1.7，但 llvm-config --version 显示 18.1.8——这说明你本地混用了不同版本的 LLVM 组件，通常是旧版残留或 PATH 混杂了多个安装路径。
排查步骤：
- 分别运行
which clang和which llvm-config，看是否指向同一 Cellar 子目录（如/opt/homebrew/Cellar/llvm/19.1.7/bin/clang） - 若不一致，可能是之前装过
llvm@18等旧版，未完全卸载；可运行brew uninstall llvm@18（如有）并清理brew cleanup -
llvm-config必须与clang同版本才能保证头文件、库路径、IR 语义兼容；否则 CMake 项目里find_package(LLVM)可能链接错库，导致编译失败或运行时崩溃
需要特定 LLVM 版本（比如 17 或 19）怎么办
Homebrew 默认只保留最新稳定版（当前为 19.x），但你可以通过 tap 回溯安装历史版本：
- 先搜索可用版本：
brew search llvm@（注意末尾 @ 符号） - 若显示
llvm@17、llvm@19等，直接安装：brew install llvm@19 - 安装后，其二进制位于独立路径（如
/opt/homebrew/opt/llvm@19/bin/clang），不会干扰主llvm包 - 如需默认使用该版本，把对应 bin 目录加到
PATH最前，或创建别名：alias clang19="/opt/homebrew/opt/llvm@19/bin/clang"
真正容易被忽略的是：LLVM 版本必须和你的项目目标（比如 MLIR、libc++、或某个编译器教程）严格对齐。差一个小版本，.ll 文件语法、llvm::Pass 接口、甚至 clang -x c++ 的默认标准都可能变化——不是“差不多能跑”，而是“大概率报错”。
