# Snow Compiler - 后端模块

> Snow 编译器的后端模块 —— 负责将中间表示（IR）翻译、优化并生成虚拟机指令序列（VM）

## 项目简介

**后端模块（Backend）** 是 [Snow 编译器]() 的核心组成部分之一，承接中间表示（IR）与运行时虚拟机（VM）之间的桥梁。
它主要完成以下工作：

1. **寄存器分配**：将 IR 中的虚拟寄存器映射为物理槽号或栈槽；
2. **指令生成与调度**：为每条 IR 指令分配对应的 VM 指令生成器，并负责调用它们输出指令文本；
3. **程序构建**：管理函数入口、标签定义、延迟修补（fix-up）CALL/JUMP 等控制流指令地址；
4. **操作码与常量映射**：提供 IR 操作码到 VM 操作码的映射工具，以及根据常量类型选择 PUSH/STORE 指令。

后端模块设计注重可扩展性：各类 IR → VM 的转换逻辑被拆分到不同的 `*Generator` 类中，新增指令只需注册新的生成器；寄存器分配和程序构建也各司其职，职责清晰，便于维护和测试。

## 核心功能

* **线性扫描寄存器分配**：`RegisterAllocator` 按参数优先、指令顺序为 IR 虚拟寄存器分配连续槽号。
* **指令生成器体系**：`InstructionGenerator<T>` 接口 + 多个 `*Generator` 实现，支持二元运算、跳转、调用、标签、常量加载、一元运算、返回等指令。
* **生成器调度**：`VMCodeGenerator` 建立类型到生成器的映射，遍历 IR 函数体并分发调用，实现多态化指令生成。
* **程序构建与延迟修补**：`VMProgramBuilder` 维护指令流、符号地址表及待修补列表，实现对 `CALL`/`JUMP` 等指令的延迟地址填充。
* **操作码与常量映射**：`IROpCodeMapper` 提供 IR 操作码到 VM 指令名的静态映射；`OpHelper` 基于反射获取 VMOpCode 常量，并根据值类型（I/L/F…）选择合适的 PUSH/STORE 操作码。

## 模块结构

```
backend/
  ├── core/
  │   └── InstructionGenerator.java     // 通用指令生成器接口
  ├── generator/
  │   ├── BinaryOpGenerator.java        // 二元运算
  │   ├── UnaryOpGenerator.java         // 一元运算
  │   ├── LoadConstGenerator.java       // 常量加载
  │   ├── CallGenerator.java            // 函数调用
  │   ├── ReturnGenerator.java          // 函数返回
  │   ├── CmpJumpGenerator.java         // 条件跳转
  │   ├── JumpGenerator.java            // 无条件跳转
  │   └── LabelGenerator.java           // 标签定义
  ├── alloc/
  │   └── RegisterAllocator.java        // 线性扫描寄存器分配
  ├── builder/
  │   ├── VMCodeGenerator.java          // 指令生成调度
  │   └── VMProgramBuilder.java         // VM 程序构建与 fix-up
  └── util/
      ├── IROpCodeMapper.java           // IR → VM 操作码映射
      └── OpHelper.java                 // opcode 反射 & 常量指令辅助
```

## 开发环境

* JDK 24 或更高版本
* Maven 构建管理
* 推荐 IDE：IntelliJ IDEA

---
