如何让 Codex 快速读懂一个陌生代码库

接手旧项目时，最浪费时间的事情之一就是到处点文件。Codex 很适合做代码库导览，但不要只问一句“这个项目是干什么的”。更好的方式，是让它围绕一个真实业务链路去追踪代码。

例如你刚接手一个商城项目，可以问：

先不要改代码。
请追踪“用户提交订单”这条链路：
从 HTTP 路由开始，一直到 controller、service、repository、数据库写入、消息队列或缓存。
列出涉及的关键文件、函数和调用关系。
最后指出最适合下断点的位置。

这种问法比“介绍项目架构”更有价值，因为你最终得到的是一条可以直接用于调试的调用链。

还可以继续追问：

订单金额最终在哪里计算？
优惠券在哪一步校验？
库存扣减失败后如何回滚？
哪些地方可能产生重复下单？

对于大仓库，最好让 Codex 以“问题驱动”方式阅读，而不是漫无目的扫描所有代码。你也可以要求它把结果整理成：入口文件、核心函数、数据结构、外部依赖、风险点五部分。

如果 Codex 的回答里出现关键路径错误，不要直接进入修改阶段。先让它重新核对文件和调用关系。理解阶段的错误如果没纠正，后面通常会被放大成错误修改。

把 Codex 当成一个会替你搜索、阅读、串联代码的高级同事，而不是代码搜索框，效果会好很多。