GraphQL Code Generator 中类型声明生成问题解析

问题背景

在使用 GraphQL Code Generator 的 TypeScript 插件时，开发者发现了一个关于类型声明生成的异常行为。具体表现为：当从 GraphQL Schema 生成类型时，插件会忽略 schema 中的 type 声明，而只生成 input 类型。

问题表现

以一个简单的 GraphQL Schema 为例：

type Test {
  name: String
}

input TestCreate {
  name: String
}

在这种情况下，生成的 TypeScript 类型定义中只包含 TestCreate 输入类型，而缺少了 Test 类型定义。

问题根源

经过分析，这个问题实际上是 GraphQL Code Generator 4.4.0 版本引入的预期行为变更。在 client-preset 4.4.0 版本中，typescript 插件的配置发生了变化，默认只生成枚举类型和操作类型，而不再自动生成所有输出类型。

解决方案

对于需要保持原有行为的开发者，有以下几种解决方案：

1. 降级方案：将 @graphql-codegen/client-preset 降级到 4.3.3 版本

2. 升级方案：升级到 4.5.0 或更高版本，并了解新的默认行为

技术背景

GraphQL Code Generator 的这一变更反映了客户端代码生成的最佳实践。在客户端应用中，通常不需要完整的输出类型定义，因为：

1. 客户端主要关注操作（查询、变更等）和输入类型
2. 输出类型通常由服务器端定义和维护
3. 减少生成的类型可以减小包体积，提高性能

最佳实践建议

对于需要完整类型定义的开发者，建议：

1. 明确区分服务端和客户端的类型生成需求
2. 考虑使用不同的配置分别生成服务端和客户端类型
3. 评估是否真的需要在客户端使用完整的类型系统

总结

GraphQL Code Generator 的这一变更虽然最初看起来像是回归问题，但实际上反映了工具向更合理的设计方向演进。开发者应该根据实际需求选择合适的版本和配置，理解工具背后的设计理念，才能更好地利用 GraphQL 生态系统的强大功能。