GraphQL Code Generator性能优化：避免重复计算片段依赖图

在GraphQL Code Generator项目中，@graphql-codegen/visitor-plugin-common包的一个性能问题被发现并修复。这个问题涉及到客户端基础访问器(ClientSideBaseVisitor)中片段依赖图的重复计算，导致代码生成时间显著增加。

问题背景

在GraphQL代码生成过程中，ClientSideBaseVisitor负责处理客户端相关的代码生成逻辑。其中一个关键功能是分析和管理GraphQL片段之间的依赖关系。这些依赖关系被存储在fragmentsGraph属性中，该属性原本被实现为一个计算属性(getter)。

性能瓶颈分析

通过性能分析发现，fragmentsGraph的重复计算成为了主要的性能瓶颈。具体表现在：

1. 每次访问fragmentsGraph时都会重新构建整个依赖图
2. 在生成代码过程中，这个属性会被频繁访问
3. 依赖图的构建涉及递归操作，计算成本较高

在中等规模的项目中，这种重复计算导致代码生成时间从约50秒增加到130秒，性能下降了近2.6倍。

技术细节

fragmentsGraph属性的计算依赖于两个因素：

1. _fragments: 存储所有加载的片段，是一个只读的Map结构
2. _extractFragments: 递归方法，用于提取片段依赖关系

由于_fragments在初始化后不会被修改，且_extractFragments的结果仅依赖于_fragments，因此fragmentsGraph的值实际上是不变的。

优化方案

将fragmentsGraph从计算属性改为常规属性，在初始化时只计算一次。这种改变带来了以下优势：

1. 避免了重复计算的开销
2. 保持了相同的功能和行为
3. 减少了内存分配和垃圾回收的压力

优化效果

实施这一优化后，在相同项目中：

• 代码生成时间从约130秒降至50秒
• 性能提升约2.6倍
• CPU使用率显著降低

最佳实践建议

对于类似场景，开发者可以考虑以下优化策略：

1. 对于计算结果不变的数据，考虑使用缓存或预计算
2. 避免在频繁调用的方法中使用昂贵的计算
3. 使用性能分析工具识别真正的瓶颈
4. 对于递归操作，考虑是否可以缓存中间结果

这一优化已被合并到GraphQL Code Generator的主分支，并在后续版本中发布，为使用该工具的开发团队带来了显著的性能提升。