GraphQL Code Generator 5.7.0版本发布：新增includeExternalFragments选项支持

GraphQL Code Generator是一个强大的工具链，它能够根据GraphQL Schema自动生成类型安全的代码，支持多种编程语言和框架。这个工具极大地简化了GraphQL开发流程，帮助开发者减少手动编写类型定义的工作量，提高开发效率和代码质量。

在最新发布的5.7.0版本中，GraphQL Code Generator引入了一个重要的新功能：includeExternalFragments选项。这个选项为开发者提供了更灵活的控制权，可以决定是否在生成的代码中包含外部片段。

includeExternalFragments选项详解

includeExternalFragments是一个布尔类型的选项，当设置为true时，生成的代码会包含所有引用的外部片段；当设置为false时，则会忽略这些外部片段。这个选项主要影响以下插件：

1. @graphql-codegen/visitor-plugin-common：这是基础插件，为其他插件提供公共功能
2. @graphql-codegen/typescript-operations：用于生成TypeScript操作类型

这个功能的引入解决了开发者在使用片段时的特定需求。在某些场景下，开发者可能希望保持生成的代码简洁，不包含外部片段定义；而在其他场景下，又需要确保所有依赖的片段都被完整包含。现在，通过这个选项可以轻松实现这两种需求。

相关插件更新

除了基础插件外，多个依赖插件也同步更新以支持这一新功能：

• typescript-document-nodes更新至4.0.14版本
• gql-tag-operations更新至4.0.15版本
• typescript-operations更新至4.5.0版本（这是主要实现该功能的插件）
• typescript-resolvers更新至4.4.3版本
• typed-document-node更新至5.0.14版本
• typescript更新至4.1.4版本

这些插件的更新确保了整个生态系统中对新功能的良好支持。

client-preset插件的改进

在4.6.3版本的client-preset插件中，修复了一个关于@client指令的重要问题。之前版本中，带有@client指令的片段扩展在生成的持久化文档中未被正确移除，这可能导致不必要的数据请求或类型错误。这个修复确保了客户端指令能够正确影响代码生成过程。

实际应用场景

这个新功能特别适用于以下场景：

1. 微前端架构：当多个微前端共享片段时，可以控制是否包含这些共享片段
2. 代码拆分：在大型项目中，可以按需包含片段，优化生成的代码体积
3. 类型安全：确保即使不包含片段，类型系统也能正确工作

升级建议

对于现有项目，建议开发者：

1. 评估是否需要使用includeExternalFragments功能
2. 如果使用片段共享模式，可以考虑设置为true
3. 如果追求最小化生成的代码体积，可以设置为false
4. 测试生成的代码是否满足预期，特别是类型检查和行为

这个版本的发布进一步丰富了GraphQL Code Generator的功能集，为开发者提供了更多控制代码生成过程的选项，使得这个工具在各种复杂场景下的适用性更强。