关于本书

《The Riddle Book》面向已经接触过至少一门编程语言、希望实际写出 Riddle 程序的读者。它既是循序渐进的教程，也是当前实现的入口索引；完整语法、错误码和编译器能力则放在附录中，避免参考资料打断学习主线。

如何阅读

本书按依赖关系组织内容：

1. 用 Clue 创建并运行第一个项目；
2. 学习注释、变量、类型、函数、表达式、块和控制流等通用概念；
3. 理解移动、借用、逃逸与析构；
4. 使用结构体、枚举与模式组织数据；
5. 用 Option、Result 与 panic 处理失败；
6. 学习泛型、trait、impl 和模块等抽象机制；
7. 学习集合、闭包与迭代器等标准库能力；
8. 最后进入项目构建、编辑器、FFI 与工具链参考。

教程章节解释“为什么这样写”，工程章节解释“如何完成一个工作流”，附录回答“当前实现到底支持什么”。后面的章节默认读者已经掌握前面的概念。

内容边界

Riddle v0.2.3 仍是技术预览，语法和 ABI 可能发生不兼容变化。本书只描述当前仓库中已经实现并能由源码、测试或工具行为验证的功能，不把路线图写成现状。

如果教程、状态页和编译器行为不一致，以当前编译器和标准库实现为准，并应同步修正文档。当前工具链状态集中列出能力与限制。

编排参考

本书的教学组织参考了以下资料，但没有照搬它们的语言特性：

• The Rust Programming Language：先运行程序，再逐步解释机制；“通用编程概念”“所有权与内存”“结构体与枚举”“错误处理”“泛型、Trait 与模块”“集合与函数式”的顺序都参考了它的编排；
• Kotlin 官方文档中文版：把快速上手、基础语法、类与对象、泛型、集合和工具分成不同学习阶段；
• Rust 语言圣经：把基础、进阶、工具链和实践分成不同学习阶段。

Riddle 与这些语言的具体差异见从 Rust 或 Kotlin 转到 Riddle。