导读 — 本书结构与阅读方式
本页说明本书适合谁、如何阅读，并逐章交代各篇内容与依赖关系；具体语法与 API 以正文为准。
本书适合的读者
- 已有至少一门编程语言经验、希望在 Sui 上编写 Move 2024 合约的开发者。
- 若你来自 Solidity / 其他链，建议先读第一章与第九章 · 对象模型，理解对象所有权与账户模型的差异，再进入实战章。
- 零基础编程的读者本书并非最佳选择，建议先掌握变量、函数与控制流再读第二章之后的内容。
如何使用本书
默认顺序：建议从第一章依次往后读。后文会默认你已读过前文中的术语（如 Abilities、对象所有权、PTB（Programmable Transaction Block，可编程交易块） 等）。
可以跳读吗：可以。若你已有 Move 基础，可从第九章 · 对象模型或第十二章 · 高级可编程性切入；遇到不熟悉的概念再回到对应章节。跳读时若产生困惑，回到更早的「概念章」补全通常比硬啃更快。
概念章与综合章：本书大致可分为：
| 类型 | 说明 | 本书中的位置（举例） |
|---|---|---|
| 概念章 | 系统讲解一类语言或链上机制 | 第 4–6、8 章（语言核心）；第 9–10 章（对象）；第 11 章（宏函数，紧接第 10 章之后）；第 12–14 章（Framework、模式、测试） |
| 入门综合 | 短程序贯穿「编写 → 测试 → 部署 → 调用」 | 第三章 |
| 专题综合 | 围绕代币、NFT、客户端、全栈或升级串联多节知识 | 第十五章 · 代币、第十六章 · NFT、第十七章 · 客户端、第十八章 · 全栈；升级见第十九章 |
| 实战子节 | 在具体章内给出完整小项目 | 如代币/NFT/ PAS 章中的「实战」小节 |
阅读编译器与验证器报错：Move 与 Sui 验证器会在编译或发布阶段拒绝不少「在别的语言里能写」的代码。本书部分示例会故意展示错误写法与报错信息，文中会写明「以下不能通过验证」；请勿对随机片段直接复制到项目中期望能编译通过。
命令与版本：书中命令以当前稳定 Sui CLI 为准；Move.toml 的 edition 与依赖 rev 若与本地不一致，请先对齐第二章（环境）与第六章 §6.11（Edition 与 Framework 约定），或仓库根说明。
各章导读
以下按章概述，便于你把目录当作「路线图」使用（章号与本书页首目录一致）。仓库路径：src/ 下主文件夹与章号对应——例如宏函数为 11_move_macros/（书中第十一章）、12_programmability/（第十二章）、15_tokens/（第十五章 代币）；第 1–6 章为 01_…06_。正文标题与下表以「第 × 章」为准。
入门篇（第 1–3 章） — 认识 Sui 与 Move、搭建环境、完成第一个包的编写、测试、部署与链上交互。
语言篇（第 4–6、8 章） — 包与清单、账户与交易；Move 语法基础与进阶（宏函数仅 §6.8 导读）；泛型、类型反射、编译模式等。**第 6 章末（§6.11）**集中整理 Move 2024 Edition 与 Move.toml 约定；第 8 章收尾高级语言特性，为对象篇做准备。
对象篇（第 9–10 章） — Sui 对象模型、所有权细分、拥有/共享与排序；第 10 章讲解 key / store、存储 API、内部约束、转移限制与 Transfer to Object。
Move 宏函数篇（第 11 章） — 宏函数详解，目录上在第十章之后、第十二章（Framework）之前，单独成篇。第六章 §6.8 为导读。
进阶篇（第 12–14 章） — Framework、事件、动态字段、集合与 Coin、密码学与随机数；设计模式；测试（场景、系统对象、覆盖率、Gas 分析等）。
应用篇（第 15–18 章） — 代币经济、NFT 与 Kiosk、TypeScript 客户端与 PTB、全栈 DApp 实战。
工程篇（第 19–23 章） — 第 19 章包升级与迁移；第 20 章安全实践、漏洞模式、错误处理与协议限制（与升级章互补）。随后为基础设施、前沿特性与 PAS（第二十三章）。
附录 — 术语、保留地址、Transfer API、CLI、规范与检查清单；另见延伸阅读。
源代码
本书正文与示例对应本仓库根目录；章节中的代码路径以各章说明为准。
没有「唯一正确」的阅读方式
你可以按项目需要翻到任意一章；若出现概念断层，再回到上文对应概念章即可。以你能坚持学下去的方式为准。