Cabokit LogoCabokitAITutorial
进阶
Codebase Reading Workflow

如何用 AI 阅读一个陌生代码项目

明确任务不是让 AI 直接大改代码,而是让它先帮你建立项目地图、定位目标功能、标出风险,再进入小步修改。

11 分钟更新于 2026-04-27 16:00Cabokit

准备工作

准备一个能本地打开的项目,以及一个明确目标。目标可以很小,比如“理解登录流程”“找到首页数据来源”“判断某个按钮在哪里处理点击”。

Step 01

先让 AI 画项目地图

第一次接触陌生项目时,目标不是立刻改代码,而是建立项目地图。先让 AI 总结目录、框架、入口文件和关键模块。

  • 识别框架
  • 找到入口
  • 列出关键目录

Step 02

围绕目标功能缩小范围

不要让 AI 阅读整个项目后直接改代码。给它一个明确目标,例如“找出登录页相关文件”,让它把相关文件和调用链列出来。

  • 明确目标
  • 列出相关文件
  • 说明调用关系

Step 03

让 AI 标出风险

在改动前,让 AI 先列出可能受影响的模块、边界状态、配置项和测试点。这一步能减少很多回滚成本。

  • 影响范围
  • 边界状态
  • 验证步骤

Step 04

只让 AI 做小步修改

确认项目地图后,再让 AI 执行边界清楚的小任务。每次修改后检查 diff,再运行项目或测试验证结果。

  • 先计划
  • 再执行
  • 检查 diff

示例 Prompt

请阅读当前项目结构,先不要修改代码。请总结:使用的框架、页面入口、数据入口、核心目录、启动命令,以及你不确定的地方。

我的目标是理解这个功能:____。请列出最相关的文件、它们之间的调用关系,以及我应该优先阅读的顺序。

在我修改这个功能前,请列出可能影响的模块、风险点、需要运行的测试和手动验证步骤。不要直接改代码。

请基于上面的分析,给出一个最小修改计划,包括要改哪些文件、为什么改、如何验证。确认前不要执行。

验证方式

你应该能用自己的话说清楚项目入口、目标功能相关文件、数据流向、修改风险和验证步骤。如果只能复述 AI 的总结,说明还没有真正读懂。

风险提醒

不要把生产密钥、用户数据、商业机密或未公开代码片段发给外部 AI 服务。让 AI 修改代码前,必须先确认计划和影响范围。

相关教程