AI写代码第一遍能跑,交接就崩?程序员亲历的血泪教训
上下文丢了,改着改着就迷糊了
有个现象很普遍:Codex第一次生成的代码,页面能跑、测试能过,但交付给测试同学一跑,崩了。更诡异的是,崩的地方跟代码看起来完全没关系——变量名对、逻辑对、语法对,但连调时就是不对。1
这不是Codex不给力。是因为它没有真正读懂你的项目上下文,只学了表面规则就开始干活——改的是局部最优化,而不是全局最优化。
上下文漂移,才是越改越乱的核心原因。
先让它读懂需求,别急着给代码任务
大多数人的用法是:打开Codex,输入一句"帮我实现一个登录模块",等着改代码。这是最容易翻车的姿势。
Codex会马上开始修改,但你还不知道它有没有理解错需求、会不会把边界外的模块也顺手改了、验证标准是什么。2
正确姿势是先让它说方案,再调整权限,跑完一轮后看diff、页面和测试结果。这样不容易返工。2
给它一个目标描述,而不是操作步骤。"把用户模块的校验逻辑抽成公共函数",比"打开auth.ts在第12行后面加个正则"要有效得多——前者让Codex自己检索上下文、定位文件、判断影响范围。1
别让它一口气改完
Codex一次性改十几个文件,正常吗?
看你让它干什么。改数据库字段、重构公共组件,多文件联动合理。但如果只是修一个按钮失效,却改了配置文件、测试文件、公共方法、甚至依赖文件——这就是明显的失控信号。3
分段确认机制是关键:不要一次性给出过多修改指令。每完成一个阶段,看diff、确认范围,再推进下一步。4
有个实用的提示词模板:"先不要改代码。请先读相关文件,给我一个计划:1.要改哪些文件。2.哪些地方不碰。3.改完怎么验证。4.这件事最容易出问题的点是什么。"这一步会多花一点时间,但能减少后面的返工。2
改完代码,第一件事不是跑起来
Codex说"完成",不等于验收通过。
把它理解成装修师傅说"施工完成"——接下来房主仍然要验收:开关能不能用、门能不能关、有没有漏水、做出来的效果是不是原先约定的样子。Codex负责执行,人负责验收。5
改完后必须做版本对照:看diff、确认改动范围、验证结果。这不只是为了检查Codex有没有犯错,更是为了确保上下文没有被悄悄改偏。6
Git是救命稻草。每完成一个可用阶段,就让它提交到main分支。有开发者踩过坑:做到中间出了个能用的版本,继续让Codex改,改着改着全部错乱,想回滚却发现没有版本记录——那才叫崩溃。7
方案二真的更好?还是看起来更好?
有时候Codex会给出多个方案,让你选。这时候怎么判断?
不要看代码谁更简洁,要看谁跟当前项目上下文更契合。一个看起来"优雅"的方案,如果用了项目里没出现过的模式、没有的依赖、或者改动了跨模块的公共逻辑——它就不是好方案。
有个判断标准:好方案应该能用一句话说清楚影响范围。"只改用户模块的本地状态"比"调整全局状态管理结构"更值得优先选——前提是你的任务确实只需要改本地状态。
Codex的Plan Mode就是干这个的。复杂任务先用它输出详细计划,确认后再实施——可多次修改计划,直到方向对了再动手。8
改着改着割裂了,问题出在哪?
典型失败场景:连续改了三轮,代码逻辑割裂了。变量名从userName变成account、再变成clientId;公共函数的入参格式换了两套;原本统一的错误处理逻辑变成了三个不同版本。
根因就一个:上下文在迭代中悄悄漂移了。Codex在每轮对话里读取的是最近几轮的上下文,不是最初的需求定义。改到第三轮,它可能已经忘了你第一轮说的"保持原有错误处理风格"。9
边界条件也容易漏。Codex为了让主流程更顺畅,可能会删除部分"看起来重复"的判断——try/catch被删了、空值判断变少了、错误信息被隐藏了。这些异常处理平时不触发,但线上数据一不符合预期,就是最后一道保护。3
做完了?对照这5条检查一下
每次Codex说"完成",不要只看它给的总结,还要检查实际修改内容。4
确认清单:
- 任务范围有没有跑偏:除了目标文件,有没有改动无关模块?5
- 公共逻辑有没有被顺手改:公共方法、请求封装、状态管理是否有变化?
- 异常处理有没有被删除:try/catch、空值判断、权限校验还在不在?
- 测试是真的通过还是被改宽了:测试条件有没有降低?验证的是真实需求吗?
- 依赖和配置文件有没有变化:package.json、.env、Dockerfile有没有被改?
这条清单用久了会上瘾——因为你会发现,Codex每次"不小心"的改动,都能在里面找到对应项。
今天就能上手的一条
说了很多技巧,最值得今天就用的是这条:下次让Codex改代码时,先让它说计划,再让它动手。
就这一句话,它能帮你拦住80%的失控修改。剩下的20%,靠版本管理来回退,靠Review来发现,靠清单来兜底。
Codex不是不聪明,是需要你给它画边界。边界画得越清楚,它越不容易自作主张。11
当前文章无评论,是时候发表评论了