GraphQL 2025 年 9 月规范更新要点

引言这是自 2021 年以来的首次完整规范更新，聚焦开发者体验与工具生态的可编程性提升。核心更新（已验证）OneOf 输入对象（输入联合）：通过 `@oneOf` 指令表达互斥输入，简化入口同时保持类型安全。来源：GraphQL 官方博客 2025 年 9 月版公告；Apollo 博客大会回顾。Schema Coordinates：标准化引用 schema 各部分的坐标体系，提升工具链的错误报告、溯源与 DX。来源：GraphQL 官方公告。可执行文档描述：为可执行文档添加描述，增强上下文信息与代码生成/AI 工具协作。来源：GraphQL 官方公告。完整 Unicode 语法与弃用/执行语义更清晰：改进规范细节，提高跨语言实现一致性。来源：GraphQL 官方公告与社区摘要。影响与建议模式设计：在互斥参数场景采用 `@oneOf`；优化入口点的类型表达。工具链升级：跟进 IDE/代码生成/监控与校验工具对 Schema Coordinates 与文档描述的支持。参考链接（验证来源）GraphQL 官方博客：2025-09 规范发布公告：https://graphql.org/blog/2025-09-08-september-edition/Hive：GraphQL Conf 2025 回顾（@oneOf 与坐标体系）：https://the-guild.dev/graphql/hive/blog/graphql-conf-2025-recapApollo 博客：十周年与规范更新提及：https://www.apollographql.com/blog/10-years-of-graphql-celebrated-at-graphqlconf-2025结语该版本为工具和生态提供更强的语义与坐标化基础；建议尽快评估并启用以获得更好的开发与维护体验。