GraphQL

GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data.

GraphQL‌ 是一种用于 API 的查询语言和运行时环境，由 Facebook 于 2012 年内部开发，并于 ‌2015 年开源‌。它提供了一种比传统 REST 更灵活、高效的数据获取方式，特别适用于前端需求快速变化的复杂应用场景。

核心特点

‌按需查询‌：客户端可以精确指定需要的数据字段，避免 “ 过度获取 ”（ over-fetching ）或 “ 获取不足 ”（ under-fetching ）‌。
‌单端点通信‌：所有请求通过一个统一的 GraphQL 端点（ 如 https://api.github.com/graphql ）完成，无需像 REST 那样维护多个 URL。
‌强类型系统‌：API 基于 ‌Schema（ 模式 ）‌ 定义，使用 GraphQL Schema Definition Language（ SDL ）描述数据结构，确保查询的正确性和可预测性。
‌支持嵌套查询‌：一次请求可获取关联数据（ 如查询一本书及其作者信息 ），减少网络往返次数。
‌无需版本控制‌：通过新增字段或废弃旧字段（ 使用 @deprecated 指令 ）实现 API 演进，无需发布新版本。
‌支持实时数据‌：通过 ‌Subscription‌ 机制实现服务端推送更新，适用于聊天、通知等实时场景。

核心概念

‌Query‌：用于读取数据（ 类似 REST 的 GET ）。
‌Mutation‌：用于创建、更新或删除数据（ 类似 POST / PUT / DELETE ）。
‌Subscription‌：用于监听实时事件。
‌Resolver‌：服务端函数，负责从数据库或其他源获取字段数据。
‌Schema‌：定义 API 的类型系统，包括查询、变更、订阅及自定义类型。

典型使用场景

移动端或 Web 前端需要高效加载复杂页面数据。
多端（ Web / iOS / Android ）共享同一后端，但数据需求不同。
微服务架构中聚合多个服务的数据。
需要频繁迭代 API 而不想破坏客户端兼容性。

工具与生态

‌客户端‌：Apollo Client、URQL、Relay
‌服务端‌：Apollo Server、GraphQL Yoga、GraphQL for .NET ‌
‌开发工具‌：GraphiQL、GraphQL Playground、Insomnia