探索LLVM的正确姿势：从0到1掌握编译器基础设施

为什么选择LLVM中文教程

在编译器开发领域，LLVM（Low Level Virtual Machine，底层虚拟机）犹如一把瑞士军刀，它提供了模块化、可重用的编译器组件，让开发者能够轻松构建从词法分析到代码生成的完整编译链路。对于中文开发者而言，这份LLVM入门教程翻译版项目具有不可替代的价值：

• 降低学习门槛：将官方英文文档转化为地道中文，避免因语言障碍错失核心概念
• 配套实战代码：每个理论章节都对应可运行的示例程序，实现"边学边练"的沉浸式体验
• 结构化学习路径：从基础语法树构建到高级JIT（即时编译技术）实现，形成完整知识闭环

💡 核心价值：该项目不仅是文档翻译，更是一套"理论+实践"双驱动的学习体系，特别适合希望深入理解编译器原理的开发者。

核心模块：LLVM学习的阶梯式成长路径

1. 基础认知层（Chapter01-04）

从LLVM的基本架构入手，通过实现一个简单的表达式解析器，掌握编译器前端的核心技术：

• 词法分析与语法解析（Chapter02）
• 抽象语法树（AST）构建（Chapter03）
• 中间代码（IR）生成（Chapter04）

📌 关键步骤：每个章节的toy.cpp文件都是可独立编译的完整示例，建议按照章节顺序递进学习，避免跨越式理解导致的知识断层。

2. 中级应用层（Chapter05-09）

深入LLVM的优化与代码生成机制，解锁更高级的编译器功能：

• 控制流分析与优化（Chapter05）
• 目标代码生成（Chapter06）
• 调试信息生成（Chapter07）
• 垃圾回收机制（Chapter08）

3. 高级实践层（BuildingAJIT/MCJIT）

聚焦JIT（即时编译技术）的实现与应用，探索动态编译的魅力：

• 基础KaleidoscopeJIT框架（BuildingAJIT/Chapter1）
• 惰性编译与优化管道（BuildingAJIT/Chapter3）
• 远程JIT部署（BuildingAJIT/Chapter5）

实战案例：LLVM技术的场景化落地

案例1：从0到1构建迷你编程语言

以Kaleidoscope语言为例，完整实现从源码到可执行程序的全链路：

1. 使用Flex/Bison实现词法和语法分析器
2. 构建AST并生成LLVM IR
3. 通过JIT技术实现交互式执行
4. 添加调试信息支持GDB断点调试

项目中Chapter05目录下的控制流图展示了这一过程的核心环节：

案例2：JIT编译器性能优化实践

在MCJIT目录中提供了多种JIT实现方案的对比实验：

• 初始版本：基础JIT框架实现（initial/）
• 延迟编译：函数级别的按需编译（lazy/）
• 缓存机制：已编译代码的持久化存储（cached/）

📌 避坑指南：在实现远程JIT时，需特别注意跨进程内存布局的兼容性问题，项目中RemoteJITUtils.h提供了完整的解决方案。

开始你的LLVM探索之旅

要获取完整项目代码，执行以下命令：

git clone https://gitcode.com/gh_mirrors/ll/llvm-guide-zh

项目结构采用GitBook规范组织，SUMMARY.md文件提供了完整的章节导航。建议按照"基础认知→中级应用→高级实践"的顺序学习，每个章节的README.md都包含详细的理论讲解和代码注释。

💡 学习建议：配合LLVM官方文档同步学习，该中文教程与LLVM 14+版本保持同步更新，是理论学习与工程实践的理想结合。