AI编程新手教程：从零开始用Codex读懂项目代码

为什么你需要学会用AI读懂代码

很多程序员刚开始用AI编程工具时，第一时间就想让它帮忙写代码。这个思路本身没错，但问题在于：AI写完代码后，你根本看不懂它改了哪里、为什么这么改、会不会影响其他功能。

我见过太多人把Codex、Cursor这类工具当"高级代码生成器"用，结果项目越改越乱，最后只能删库跑路。正确的打开方式应该是：先让AI带你读懂项目，再让它帮你写代码。

第一天不要急着改代码，先做这5件事

如果你第一次用AI编程工具接触一个现成项目，建议按这个顺序来：

• 让AI读项目目录，找出入口文件和启动命令
• 让它解释主要目录分别负责什么功能
• 选一个页面或功能，让它追一遍调用链
• 让它输出一份新手入门笔记
• 问它：如果我要改XXX功能，应该动哪些文件

这5件事做完，你不一定能完全看懂项目，但至少知道从哪入手，不会再出现"AI写了代码但我不敢合并"的尴尬局面。

第一步：进入项目目录（别在桌面启动AI）

这一步很基础，但特别关键。你要让AI读哪个项目，就先进入哪个项目目录。

比如你的项目在 C:\Projects\my-app，那就先cd进去，再启动AI工具。不要在桌面、下载目录、用户根目录里直接启动，因为AI需要基于当前目录判断：

• 当前项目有哪些文件
• 配置文件在哪里
• 依赖和脚本在哪里
• 哪些目录像页面、哪些像组件、哪些像接口或服务

如果目录进错了，后面AI的判断就会跟着错。所以第一天先记住：先进入项目，再启动AI。

如果你手上没有现成项目，可以找一个你之前写过的小项目，最好是你能跑起来但又没有完全看懂的那种。因为这类项目最适合练"让AI帮你读懂代码"。

第二步：第一条Prompt，先让它只读不改

启动AI后，第一句话不要写"帮我实现XXX功能"，也不要写"帮我优化代码"。第一天更稳的写法是：

请先阅读当前项目，不要修改任何代码。
请告诉我：
1. 入口文件是哪个
2. 启动命令是什么
3. 主要目录结构及各自职责
4. 用到了哪些核心技术栈

这个Prompt的关键是"不要修改任何代码"。因为你要先建立对项目的认知，而不是上来就改东西。

第三步：让它追一条完整的调用链

读懂项目最快的方式，不是从头到尾读所有代码，而是追一条完整的调用链。

比如你用的是前后端分离项目，可以这么问AI：

请帮我追踪用户登录的完整调用链：
1. 前端登录按钮点击后，调用了哪个接口
2. 后端路由是怎么转发的
3. 数据库查询是在哪个文件里执行的
4. 返回给前端的Token是在哪一步生成的

AI会把整个链路拆开讲给你听，比你自己翻代码效率高10倍。而且讲完之后，你再去看代码，就会有"原来如此"的感觉，而不是一脸懵。

第四步：让它给你输出一份新手笔记

前面几步做完后，你可以让AI帮你整理一份"项目阅读笔记"，方便以后回顾。Prompt可以这样写：

请根据我们刚才的讨论，帮我整理一份新手入门笔记，包括：
1. 项目启动步骤
2. 目录结构说明
3. 核心功能调用链
4. 常见修改场景应该动哪些文件

这份笔记的价值在于：它是专门为你当前这个项目定制的，比任何通用教程都管用。而且下次你隔了两周再回来改这个项目，直接看笔记就能快速捡起来，不用再重新读代码。

第五步：开始让AI帮你写代码（但要验算）

前面四步做完后，你才到了"让AI写代码"这一步。但即便这个时候，也不要完全当甩手掌柜。

我的做法是：

• 让AI写完代码后，一定会让它解释每一处改动
• 问它：这个改动会不会影响其他功能
• 如果是改别人的代码，会让它先说清楚改之前的逻辑是什么，再说是怎么改的

这样做有两个好处：一是你能真正理解代码，而不是当AI的代码搬运工；二是万一AI写错了（它会写错），你能及时发现，而不是等上线了才爆雷。

一个完整的实战案例

我之前接手一个用Express写的中型项目，文件夹一堆，完全不知道从哪看起。用上面的方法，我是这么做的：

步骤	我问了AI什么	我得到了什么
第1步	"请阅读当前项目，不要改代码，告诉我入口文件和启动命令"	入口是 app.js，启动命令是 npm start，端口在 .env 里配置
第2步	"routes/、controllers/、models/ 分别负责什么"	routes管路由转发，controllers管业务逻辑，models管数据库操作
第3步	"追踪用户注册功能从前端到数据库的完整调用链"	前端表单 → /api/register路由 → controller验证逻辑 → model写入数据库 → 返回结果
第4步	"整理成新手笔记"	得到一份3页的项目阅读笔记，后续改功能直接查笔记
第5步	"我要加一个邮箱验证功能，应该动哪些文件"	AI给出了具体改动方案，并解释了每处改动的原因

整个过程花了不到1小时，但我从"完全看不懂这个项目"变成了"知道怎么改这个项目"，而且后续改起来心里有底，不会出现改一处崩一片的情况。

常见坑提醒

• 坑1：直接用AI生成的代码，不验算
  AI会写错，而且写错时它不会告诉你。一定要让它解释代码逻辑，确认没问题再合并。
• 坑2：项目太复杂，一次性让AI读全部代码
  AI的上下文有限，项目太大时它会漏看。正确做法是分模块让它能，每次专注一个功能模块。
• 坑3：不写笔记，以为自己记住了
  你不会记住的。今天弄懂的东西，两周后再回来，你还是得重新读代码。整理成笔记，是在给未来的自己省时间。

总结

AI编程工具的核心价值，不是帮你写代码，而是帮你读懂代码。先让AI带你建立对项目整体结构的认知，再让它帮你写代码，这样的工作流才是可持续的。

如果你刚开始用AI编程，建议按这个顺序来：读项目 → 懂调用链 → 整理笔记 → 再写代码。别急着让AI帮你写功能，先把"让AI帮你读懂代码"这一步做扎实，后面的事情会顺很多。

相关阅读：AI工具使用技巧 | 编程入门教程