常见坑与补救

跨场景通用坑。前端专页见 避坑实录。

AI CODING · 通用坑

大多数翻车不是「模型不够聪明」，是范围没写死、验收没写清、越界了还不喊停。

优先 范围 > 细节超过 3 轮 先回滚

看清单 →

本节要点

• 假完成 / 范围蔓延 / 静默改契约等高频坑
• 分场景速查与「看起来能跑」检查单
• 回滚万能句（可贴给 AI）

清单速查检查回滚

清单

坑	症状	补救
假完成	「做好了」但点不通	验收写进 Prompt；浏览器/curl 说话
有明确目标仍用 Vibe	越改越飘	切 Spec：契约 + 范围 + 验收
范围蔓延	diff 扫半个仓库	「只改…/不要…」；超范围拒绝合并
静默改契约	字段/枚举被放宽	diff 盯类型与 JSON；打回
上下文过长	答非所问	新开对话；缩小 @
聊天代替文档	下周 AI 又忘	约定写进仓库小文档再 @
密钥进对话	安全事故	只占位符；真值走本地 env
在无效 diff 上堆	Token 与复杂度爆炸	回滚到任务起点，换更小的 Prompt
前后端字段各猜一套	联调地狱	对照表写进给 AI 的 Prompt（见场景三）
CI 红了怪模型	本地没跑等价命令	先本地复现，再贴日志纠错
为了变绿删测试	质量崩盘	禁止；修实现或修断言意图

场景速查

场景	最高频坑	先看
一	引入框架 / 自创页面	场景一
二	组件写路由 / 第二套用餐场景数组	避坑实录
三	字段三套名字 / seed 不幂等	API · 数据库
四	整仓优化 / 动鉴权	关键模块

「看起来能跑」检查单

• [ ] 主路径人工点过（不只看编译成功）
• [ ] 非法输入有空态或明确错误
• [ ] diff 无 lockfile 意外变更
• [ ] 无密钥、无本机绝对路径
• [ ] 给 AI 的 Prompt 原文已存档

团队协作

• PR 写清：哪张 Prompt、验收怎么点过
• Review 先看范围，再看实现
• 同一问题复现第二次 → 纠错话术写进习惯文档

一分钟复盘模板

这次翻车：
根因（人 / Prompt / AI）：
下次给 AI 的 Prompt 要多写的一句：
是否需要补进 Rules/文档：

回滚万能句

给 AI · 纠错 · 回滚越界先停改、对齐 git status，再按原 Prompt 最小范围重做

停止继续修改。
将本次任务允许范围之外的文件全部恢复到任务开始前。
用 git status 列表给我核对后，再按原 Prompt 最小范围重做。

回到 AI 编码习惯。

相关阅读

• Prompt 工程
• Token 省钱
• 避坑实录