稳定版指官方按季度发布的llvmorg-14.0.0等带完整版本号的归档包，开发版指直接从llvm-project主干拉取的代码；二者差异在于接口稳定性与集成成熟度：稳定版IR格式、Pass API、TargetMachine构造方式经测试，第三方工具可可靠运行，而开发版存在IRBuilder构造函数重命名、LoopInfo初始化逻辑变更、libLLVM.so符号导出微调等不兼容改动。

绝大多数用户应该选稳定版，开发版只适合明确需要某项未合入特性、且能承担构建失败或行为不一致风险的人。

稳定版 vs 开发版的实际差异在哪

稳定版指官方按季度发布的 llvmorg-14.0.0 这类带完整版本号的归档包；开发版指直接从 llvm-project 主干（main branch）拉取的代码。两者不是“功能多寡”的区别，而是“接口稳定性”和“集成成熟度”的区别：

• 稳定版的 LLVM IR 格式、Pass API、TargetMachine 构造方式都经过测试，第三方工具（如 clang-tidy、opt 插件、静态分析器）能可靠运行
• 开发版中，IRBuilder 的某些构造函数可能被重命名，LoopInfo 的初始化逻辑可能临时变更，甚至 libLLVM.so 的符号导出列表会微调——这些改动不会出现在稳定版的 patch 更新里
• 开发版的 MLIR 子项目更新频繁，但如果你没在写自定义 dialect 或 lowering，基本用不到它

哪些场景真该用开发版

只有以下情况才建议切到开发版，否则纯属增加维护成本：

• 你正在为某个新硬件后端（比如刚公布的 RISC-V XVentana 扩展）贡献代码，而该支持尚未合入最近的稳定 release
• 你需要某个 llvm-dev 邮件列表里已确认 merge 但还没打 tag 的 bugfix，例如修复了 AArch64 下 __builtin_add_overflow 的 codegen 错误
• 你在开发一个依赖 llvm::orc JIT 接口的动态语言解释器，且必须用上 main 分支里刚重构的 ExecutionSession 生命周期管理

安装时最容易忽略的兼容性陷阱

即使你选了稳定版，也得注意三件事：

• clang 和 llvm 版本必须严格一致：装 clang-15 却链接系统自带的 libLLVM-14.so，会导致 Symbol not found: _ZN4llvm12DwarfUnitC1E 这类符号缺失错误
• Ubuntu/Debian 的 apt install llvm 默认装的是系统仓库版（常滞后 2–3 个大版本），要指定 llvm-15 或用 llvm.sh 脚本才能拿到新版
• macOS 上 brew install llvm 装的是带 /usr/local/opt/llvm/bin 前缀的独立路径，必须把该路径加进 $PATH，否则 clang++ --version 显示的仍是系统自带的 Apple Clang

真正麻烦的从来不是“装哪个版本”，而是版本混用后出现的 IR verification failed 或 Segmentation fault in TargetLowering::LowerOperation —— 这些错误往往要花半天才能定位到是 libLLVM 和 clang 二进制不匹配导致的。