
真实代码库工程能力入门官方难度:Easy5-10 min
原题:Understand large codebases
理解大型代码库
追踪请求流、梳理陌生模块,并快速找到应该阅读的文件。
简介
当你刚接触一个仓库,或者被分配到一个不熟悉的功能时,Codex 可以在你开始修改代码之前帮助你建立方向感。目标不只是得到一个高层摘要,而是要画出请求流,理解哪些模块分别负责什么,并识别接下来最值得阅读的文件。
如何使用
如果你刚进入一个项目,可以直接先让 Codex 解释整个代码库:
如果你需要在现有代码库里贡献一个新功能,可以要求 Codex 解释某个具体的系统区域。你的范围限定得越好,它给出的解释就会越具体。
- 1给 Codex 相关文件、目录,或者你正试图理解的功能区域。
- 2让它追踪请求流,并说明哪些模块负责业务逻辑、传输层、持久化或 UI。
- 3在编辑任何内容之前,询问验证、边界效应或状态转换发生在哪里。
- 4最后要求它告诉你接下来应该读哪些文件,以及风险点在哪里。
示例请求
解释这个仓库。
使用建议
把 Codex 当成代码库导览员,而不是直接开工的执行者。先用它确定路径、所有权和风险,再决定要让它修改哪些文件。
- 先理解请求如何流动,再要求修改。
- 要求 Codex 明确模块职责,而不是只给目录摘要。
- 把“接下来该读哪些文件”作为每次探索的收尾。
官方 Starter Prompt 中文翻译
解释请求是如何穿过代码库中的「<系统区域名称>」的。请包含: - 哪些模块负责什么 - 数据在哪里被验证 - 在修改前最需要注意的坑 最后列出我接下来应该阅读的文件。