如何用 AI 阅读一个陌生代码项目
明确任务不是让 AI 直接大改代码,而是让它先帮你建立项目地图、定位目标功能、标出风险,再进入小步修改。
阅读路线
地图 · 范围 · 风险 · 小步修改
准备工作
准备一个能本地打开的项目,以及一个明确目标。目标可以很小,比如“理解登录流程”“找到首页数据来源”“判断某个按钮在哪里处理点击”。
Step 01
先让 AI 画项目地图
第一次接触陌生项目时,目标不是立刻改代码,而是建立项目地图。先让 AI 总结目录、框架、入口文件和关键模块。
- 识别框架
- 找到入口
- 列出关键目录
Step 02
围绕目标功能缩小范围
不要让 AI 阅读整个项目后直接改代码。给它一个明确目标,例如“找出登录页相关文件”,让它把相关文件和调用链列出来。
- 明确目标
- 列出相关文件
- 说明调用关系
Step 03
让 AI 标出风险
在改动前,让 AI 先列出可能受影响的模块、边界状态、配置项和测试点。这一步能减少很多回滚成本。
- 影响范围
- 边界状态
- 验证步骤
Step 04
只让 AI 做小步修改
确认项目地图后,再让 AI 执行边界清楚的小任务。每次修改后检查 diff,再运行项目或测试验证结果。
- 先计划
- 再执行
- 检查 diff
示例 Prompt
请阅读当前项目结构,先不要修改代码。请总结:使用的框架、页面入口、数据入口、核心目录、启动命令,以及你不确定的地方。
我的目标是理解这个功能:____。请列出最相关的文件、它们之间的调用关系,以及我应该优先阅读的顺序。
在我修改这个功能前,请列出可能影响的模块、风险点、需要运行的测试和手动验证步骤。不要直接改代码。
请基于上面的分析,给出一个最小修改计划,包括要改哪些文件、为什么改、如何验证。确认前不要执行。
验证方式
你应该能用自己的话说清楚项目入口、目标功能相关文件、数据流向、修改风险和验证步骤。如果只能复述 AI 的总结,说明还没有真正读懂。
风险提醒
不要把生产密钥、用户数据、商业机密或未公开代码片段发给外部 AI 服务。让 AI 修改代码前,必须先确认计划和影响范围。
相关教程
使用 Antigravity 一键生成朋友圈九宫格无缝拼图
厌倦了千篇一律的朋友圈配图?这篇教程教你利用 AI 生成细节炸裂的超清中心构图大图,并指挥 Agent 编写自动化切割脚本,一键斩获视觉冲击力拉满的 3x3 完美九宫格海报!
使用 Antigravity 生成精美网页配图与 16:9 封面
完整演示如何在 Antigravity 中调用大模型生成网页配图,并通过提示词策略与 Python 脚本实现完美的 16:9 无损居中裁剪。
使用 Antigravity 一键压缩超大屏幕录制视频
屏幕录制的视频动辄几百兆无法上传?教你如何通过一句自然语言指令,让 Agent 全自动调用底层工具 FFmpeg,将 200MB+ 的 2K 视频高质量压缩至几兆大小。
VS Code 接入 Codex 教程
从安装 Codex 扩展、登录 OpenAI 或 ChatGPT 账号、打开 demo 项目,到第一次让 Codex Agent 规划、执行和验证任务。