导语:AI 能写代码,也能当你的"逐行注释老师"——把看不懂的代码贴给它,让它用大白话讲清楚。但关键是:哪些必须看懂,哪些知道就行。
写代码有 AI 帮你(22 篇工作流),但验收 AI 写的代码(22 篇④验证),你得能读懂一部分。好消息是:读代码也有 AI——看不懂就贴给它,让它逐行讲。
但"全看懂"既不现实也没必要。这一篇教你:怎么让 AI 讲、哪些必懂、哪些跳过。
一、为什么必须会"读一点"
- AI 写的代码,你要负责验收(22 篇:先讲思路、验证输出)——看不懂怎么验收?
- 出了问题你要能定位(28 篇:去哪找报错)——看日志和看代码是一回事。
- 以后改需求,要能说清楚改哪——让 AI 改对地方的前提,是你知道大概结构。
经验:"会读 20%,会写 80%(AI 写)"是 AI 时代新人的标配——你不用全懂,但入口、路由、数据库这几处必须懂。
二、让 AI 逐行解释:提示词模板
把看不懂的代码贴给 AI,加一句"要求":
"这是 (函数/文件),帮我逐行解释,用大白话,不要只讲语法:
① 每行/每段是干什么的(不是"这是什么语句",是"这步在做什么");
② 标出哪几行最关键(删了/改错会影响核心功能);
③ 最后用一句话总结这段代码的整体作用。"
经验:关键在"干什么"而不是"是什么"——"这是 for 循环"没用,"这段在遍历待办列表、找出未完成的"才是你该懂的。
三、哪些代码该看懂,哪些可以跳过
| 类别 | 例子(待办应用) | 态度 |
|---|---|---|
| 入口 | app.py 的启动、路由注册 |
必懂 |
| 路由/接口 | @app.route 四个接口 |
必懂(23 篇) |
| 数据库操作 | 增删改查 SQL | 必懂(23 篇) |
| 核心逻辑 | 缓存读写流程 | 必懂(27 篇) |
| 依赖/配置 | requirements.txt、compose 文件 | 知道就行(18 篇) |
| 模板/页面结构 | HTML 骨架 | 知道就行 |
| 样式细节 | CSS 颜色间距 | 跳过 |
| 工具函数 | 日期格式化之类 | 知道就行 |
经验:"改不改它、坏了找不找它、是不是逻辑核心"——三个问题答一个"是",就该看懂;全"否",知道就行。
四、怎么区分"需要理解"和"知道就行"
拿到一段 AI 写的代码,按三步筛:
- 它在哪个层?(28 篇四层:入口/应用/数据/资源)——入口、数据层必懂。
- 我会改它吗?(下个需求要动它)——要动就懂。
- 它出错影响什么?(核心功能挂了?)——影响大就懂。
经验:先问自己这三个问题,再决定要不要让 AI 逐行讲——省下的时间比你想的多。新手最常见的错是"全都要懂",结果陷在 CSS 颜色里出不来。
五、避坑清单
- 别让 AI 只讲语法:要"这段在干什么",不要"这是 if 语句"(二)里的模板直接用。
- 别一次贴太多:一次一个函数/文件,贴多了 AI 讲不透、你也记不住(29 篇:一次一问)。
- 别跳过关键 20%:入口、路由、数据库必懂——这三处不懂,后面全是空中楼阁。
- 别只读不跑:理解不了就跑一遍看输出(22 篇③验证)——代码是跑出来的,不是读出来的。
- 别问"这是什么意思":改成"这段的作用是什么"——答案质量完全不同。
总结
- 会读 20% 就够了:入口、路由、数据库、核心逻辑必懂;配置、模板、样式知道就行。
- 逐行解释模板:贴代码 + 大白话 + "干什么" + 标关键行 + 一句话总结。
- 三个筛子:在哪个层、会不会改它、出错影响什么——决定要不要深读。
- 避坑四条:不讲语法讲作用、一次一个函数、关键 20% 必懂、只读不如跑一遍。
10 分钟小任务:打开你的待办应用代码(23/24 篇),挑最看不懂的一个函数,用二里的模板让 AI 逐行解释——重点看它标的"关键行",对照 23 篇的路由-数据库对照表,试着讲给别人听(讲得出来 = 真懂了)。下一篇,回到你最熟悉的地方:Docker 容器跑不起来怎么办。
下一篇:Docker 容器跑不起来?90% 的问题就这 3 类。
