CodeGraph

## 项目概述 CodeGraph 是一个面向大型代码库的 AI 分析工具，专注于解决一个很多开发者都遇到过的问题：接手的项目有几十万行代码，没人能说清楚整体架构是什么样的。传统的代码阅读方式（grep、阅读文档、打断点调试）在面对大型项目时效率极低。CodeGraph 的做法是用静态代码分析 + AI 推理来自动构建整个代码库的"知识图谱"——模块之间的依赖关系、数据流向、接口定义、变更影响范围等，全部可视化展示。 ## 核心功能 架构可视化是 CodeGraph 最亮眼的功能。它能为整个项目自动生成依赖关系图，展示模块间的调用链路和数据流。对于微服务项目，它还能绘制服务间的 API 调用拓扑图。这些图表不是简单的 UML 类图，而是基于实际代码执行的动态分析结果。 智能代码审查模块会基于项目的架构分析结果，自动识别设计模式违规、循环依赖、过度耦合等问题，并给出具体的重构建议。比如"模块 A 和模块 B 之间存在 15 处跨层调用，建议引入防腐层（Anti-Corruption Layer）"。 变更影响分析是另一个对大型项目团队极有价值的功能——修改某个接口前后，系统会分析出受影响的模块列表和风险等级，在代码审查阶段就给开发者提供决策依据。技术债务评估功能则从代码质量、测试覆盖率、文档完整度等维度，给项目的健康状况打分并追踪变化趋势。 ## 技术架构 CodeGraph 使用 TypeScript 编写，核心是一个语言无关的 AST 分析引擎，通过 Language Server Protocol（LSP）桥接不同语言的解析器。目前支持 JavaScript/TypeScript、Python、Java、Go 四种主流语言。数据存储采用图数据库（Neo4j），因为代码的依赖关系天然是图结构，用关系型数据库存储会丢失语义。 ## 适用场景 最适合大型项目的架构治理——从单体架构向微服务迁移时评估依赖关系、遗留系统的重构规划、新成员快速了解项目全貌。 ## 评测总结 优点：架构可视化直观、变更影响分析非常实用（减少线上事故）、支持多种主流语言。不足：对动态语言（Python/JS）的分析精度不及静态语言；图数据库的查询响应在大规模项目（百万行+）下有性能衰减。推荐指数：★★★★☆（4/5）。大型项目的架构治理利器。