我是怎么用 GPT-5.5 分析一个陌生项目源码的

2 阅读5分钟

拿到一个完全陌生的项目,怎么用 GPT-5.5 快速看懂它。

这次我分析的是一个叫 autofit.js 的项目。我是随机选取的一个 github上开源的项目。

  1. 分析源码结构
  2. 梳理核心模块关系
  3. 画出架构图
  4. 最后把整个学习过程沉淀成笔记

这一套流程下来,我对 GPT-5.5 的感受很直接:

它最有价值的地方,不是替你“看代码”,而是替你把理解过程结构化。

一、为什么我要用 GPT-5.5 分析源码

平时拿到一个新项目,最常见的问题不是“看不懂某一行”,而是:

  • 不知道入口在哪
  • 不知道哪些模块是核心
  • 不知道主流程怎么走
  • 看完源码之后,很难快速整理成输出材料

尤其是当你不是去维护它,而是去学习它、理解它、吸收它的时候,这种“从陌生到建立结构认知”的过程特别重要。

所以这次我没有直接自己从头硬啃,而是让 GPT-5.5 参与整个过程。

我的思路不是让它替我完成学习,而是让它成为一个:

源码阅读助手 + 结构整理助手 + 文档输出助手 + 图示生成助手

二、这次实操的真实流程

1. 先给出目标,不让 AI 只停留在“解释代码”

我一开始给它的任务,不是简单一句“帮我看懂这个项目”,而是带着明确结果去提问:

  • 分析 磁盘目录\autofit.js 里面的源码
  • 然后绘制架构图
  • 源码分析输出到这个目录 root 中

这个目标很关键。

因为如果你只说“分析一下源码”,AI 很容易停在泛泛解释层面;但你一旦要求它产出文件、产出架构图、落到目录里,它就会开始从“聊天回答”切换到“交付结果”的模式。

2. 它先读外围信息,而不是直接扎进源码细节

项目结构确认之后,它没有马上逐行解释 src/index.ts,而是先去读:

  • package.json
  • readme.md
  • readme.en.md
  • rolldown.config.ts
  • rolldown.config.dev.ts

这个顺序非常对。

因为理解一个陌生项目,最有效的方法通常不是一上来盯着实现细节,而是先看外围:

  • 这个项目是干什么的
  • 它的入口文件是什么
  • 它怎么构建
  • 它暴露哪些能力
  • 它是给谁用的

这一层上下文一旦建立起来,后面再看 src 目录,理解速度会快很多。

3. 再进入核心源码,抓主流程而不是死抠所有细节

接下来它重点分析了 src 目录下的几个核心文件:

  • index.ts
  • strategy.ts
  • rectification.ts
  • state.ts
  • types.ts

然后把整个项目的骨架梳理出来了:

  • index.ts 是对外 API 门面
  • init() 是初始化入口
  • off() 负责清理副作用
  • keepFit() 是核心缩放策略
  • state.ts 保存共享运行时状态
  • elRectification() 处理局部元素修正

这一点很像一个有经验的工程师在带你读代码:
它不是先解释每一行,而是先告诉你:

这几个模块分别是什么角色,它们之间怎么协作。

对于学习一个陌生项目来说,这种方式比“从上到下翻译代码”有效太多了。

4. 不只是分析,还输出成 Markdown 文档

学习过程不是“看完就结束”,而是被沉淀成了可以复用的材料。

这很重要。因为很多时候我们自己读完源码,脑子里好像懂了,但过两天就忘了。
而一份结构化文档,能把你的“当下理解”固化下来,之后回看成本会低很多。

三、从“看懂源码”到“画出架构图”

如果说源码分析解决的是“理解”,那架构图解决的就是“表达”。

这次我直接指定:

使用 architecture-diagram skill 再绘制一个架构图,名称叫 autofit.js-架构图

四、实际用到的 skill

1. architecture-diagram

这个是这次画架构图的关键 skill。它的特点比较明确:

  • 深色主题
  • 内联 SVG
  • 适合画技术架构图
  • 有固定的组件配色和图例风格

用它来画源码模块关系图,比让模型自由发挥要稳定得多。

image.png

五、 Prompt

分析 目录\autofit.js 目录 里面的源码。然后绘制架构图,源码分析输出到这个目录的 root 中。使用 architecture-diagram skill 再绘制一个架构图,名称叫 autofit.js-架构图

六、我从这次过程里总结出的几个经验

1. 不要只让 AI “解释”,要让它“交付” 产物

如果只是问“这段代码是什么意思”,你得到的通常还是聊天式回答。
但如果你要求它:

  • 生成文档
  • 画图
  • 输出到目录
  • 修改已有文件

它就更像一个真正参与工作的助手。

2. 分析陌生项目时,先看外围再看核心

这次 GPT-5.5 的处理顺序我很认可:

先 package.json、README、构建配置,
再 src 目录核心文件,
最后再整理模块关系。

七、最后

GPT-5.5 在源码分析场景里,最强的能力不是替你读代码,而是帮你建立理解框架。

它能帮你:

  • 快速定位项目入口
  • 提炼核心模块
  • 梳理调用链和状态流转
  • 把源码理解沉淀成文档
  • 再进一步变成架构图和学习笔记

对我来说,这已经不只是“AI 辅助编码”了,
而是“AI 辅助学习和知识建模”。