第 1 章 · 概览与起步

> **本章目标**：在 30 分钟内建立对 RML 框架的整体认知，并跑通第一个应用。本章不深入任何细节，只回答三个问题——RML 是什么、为什么用它、怎么开始用。

章节大纲

| 小节 | 主题 | 阅读时长 | | ----------------------------------------------------------------- | ------------ | ------ | | [1.1 设计理念与哲学](./design-philosophy.md) | 三条根本原则与设计目标 | 8 分钟 | | [1.2 架构总览](./architecture.md) | 三层架构与 MVVM 数据流 | 10 分钟 | | [1.3 快速开始](./quick-start.md) | 从零搭建第一个 RML 应用 | 15 分钟 | | [1.5 开发者指南](./developer-guide.md) | 端到端开发流程与 Demo 模式 | 20 分钟 | | [1.4 与原生 GPUI 的对比](./comparison.md) | 三种方案的横向对比 | 7 分钟 |

阅读建议

- **如果你是完全新手**：按顺序读完四节，再进入第 2 章。 - **如果你已熟悉 GPUI**：直接跳到 [1.4 对比](./comparison.md)，再回头读 [1.2 架构](./architecture.md)。 - **如果你只想快速跑通**：直接读 [1.3 快速开始](./quick-start.md)。 - **如果你要开发完整应用**：读完快速开始后读 [1.5 开发者指南](./developer-guide.md)。

关键概念速览

| 概念 | 一句话定义 | | --------------- | ------------------------------------------- | | **`.rml`** | 独立的 UI 标记文件，使用 HTML 语法描述界面结构 | | **`.rml.rs`** | Code-Behind 文件，纯 Rust 业务逻辑 | | **ViewModel** | 实现 `Model` trait 的 GPUI Entity，持有状态并响应命令 | | **数据绑定** | `.rml` 通过 `{ }` 插值消费 ViewModel 字段 | | **命令** | `#[command]` 标记的方法，可被 `.rml` 中的事件直接调用 | | **编译期生成** | `build.rs` 在编译期把 `.rml` 转为原生 GPUI 渲染代码 |

下一节 → [1.1 设计理念与哲学](./design-philosophy.md)