Codex 生成可核对的项目地图
本页目标
学完本页，你能得到一份包含入口、模块职责、典型请求流、风险点和阅读顺序的项目地图，并抽查其中的文件证据。
验证范围（2026-07-11） 项目上手方法已对照 OpenAI 官方案例；下方中文提示词未在制作环境完成 CLI 实机回放。项目地图中的每条路径和调用关系都必须由你在真实仓库中抽查。
开始前
选择一个可以恢复的 Git 练习项目，先运行 git status --short，记下项目原有改动。项目地图的价值不是列出大量文件，而是说明文件如何连接，以及接下来应该读什么。
官方代码库上手案例建议先确认模块归属、请求流、校验位置、风险点和下一批文件，再开始修改。界面随版本变化，以当前界面为准。
跟着做
- 在项目根目录启动 Codex，确认当前目录正确。
- 提交下面的只读项目地图提示词。
- 随机打开回答中的三个文件，核对路径和职责。
- 沿“典型请求流”至少检查相邻两个文件是否真的存在导入、调用、路由或配置关系。
Codex · 可复制提示词
生成有证据的项目地图
请只读生成当前项目的项目地图，不要修改文件。
请包含：
1. 用一句话说明项目用途，并给出证据文件；
2. 用表格列出用户入口、路由或 API、核心业务逻辑、数据或持久化、测试与配置，每项写明真实路径和职责；
3. 追踪一条最常见的请求或用户操作，从入口一直到数据或最终输出；
4. 标出三个修改时容易遗漏的风险点；
5. 推荐接下来最值得阅读的五个文件，并说明原因。
只写能由当前文件证明的结论；无法确认的地方标为“待确认”。预期结果
得到包含真实路径、模块关系、请求流、风险和阅读顺序的项目地图
结果检查
合格地图至少包含五个真实文件路径，并且不只是目录清单。请求流中的相邻步骤应能在导入、调用、路由或配置中找到连接依据；无法证明的连接必须标为待确认。
最后再次运行 git status --short，确认前后状态一致。如果路径或调用关系有误，指出具体证据让 Codex 修正，不要带着错误地图进入代码修改。
练习
动手练习
把项目地图缩小到一个功能
选择登录、搜索或提交表单中的一个功能，让 Codex 只追踪该功能的入口、校验、业务逻辑和测试。
完成标准：得到一条可沿文件逐步核对的调用链，并列出修改后应运行的测试或检查。
本页小结
可靠的项目地图要回答“谁负责什么、数据怎样流动、哪里最危险、下一步读什么”。每个关键结论都应回到真实文件，而不是只相信看起来合理的总结。