这一章是GraphQL知识体系的核心骨架。Schema类型系统定义了"你能查什么",操作类型定义了"你怎么查/改/订阅",查询语法定义了"你具体要什么",类型详解展开每种类型的特性,解析器机制解释"服务器怎么执行"。
把这五章读完,你就掌握了GraphQL的完整概念模型——后面所有的服务端构建、客户端实践、高级主题都是基于这些概念的工程展开。如果只读一章,就读这章。
第一节:Schema 与类型系统 SDL。Schema 是 GraphQL 的宪法,用 SDL 语言声明"能查什么、能改什么、能订阅什么"。这一节用一个电商 Schema 串起对象、接口、联合、输入、枚举、标量等全部构造,并给出 SDL 语法速查和按领域拆分 Schema 的组织策略。
第二节:查询、变更与订阅三种操作。Query 读、Mutation 写、Subscription 实时推送,三种操作的语义边界、命名约定和适用场景,以及它们各自对执行引擎的约束。
第三节:查询语法详解。字段选择、参数与默认值、别名、片段、变量、内联片段与类型条件——这些语法元素是客户端每天都在写的东西,也是服务端性能优化的切入点。
第四节:类型系统详解。标量、对象、枚举、接口、联合、输入类型的底层行为与选择依据,包括自定义标量怎么实现、接口与联合怎么取舍。
第五节:执行流程与解析器 Resolver。从解析、验证、执行到响应组装的一次完整请求旅程,重点讲解析器四参数模型、默认解析器、并发执行与部分成功语义——这是调试 GraphQL 服务端一切问题的根基。
本章的五个小节环环相扣:没有类型系统,查询语法就无从验证;没有操作类型,执行引擎就不知道从哪个入口开始;没有 Resolver,再好的 Schema 也无法取到数据。建议在动手写第一个 GraphQL 服务前,先把本章通读一遍——它是后面所有章节的地基,跳过的每一个概念都会在后面以更难理解的方式回来。