VVibeCoding 助手
🧯03 阶段 · 避坑

排查流程:从报错到解决的四步法

遇到任何报错都不慌:收集信息、复现、让 AI 修复并解释、验证。配一套万能话术。

10 分钟 · ✅ 4 个实操任务

先改变心态:报错是信息,不是灾难

新手看到红色报错就慌。其实报错是 AI 最好的线索——它精确地告诉你哪里出了问题。你只需要学会把这份线索完整地交给 AI。

四步排查法

第一步:收集完整信息

把下面三样东西原样复制:

  • 报错文字(整段,不要只复制一行)
  • 你刚刚做了什么操作
  • 期望的结果(你本来想让它变成什么样)

第二步:原样发给 AI,让它先解释

我做了 [操作],结果报了这个错:

[完整报错贴在这里]

先不要修复。先用大白话告诉我:这个报错是什么意思、可能是什么原因。

先解释、后修复,能避免 AI 乱猜乱改。

第三步:确认方案后再修

明白了。请给我修复方案:改哪个文件、改什么、会不会影响其他功能。我确认后你再动手。

第四步:验证 + 记笔记

修好了吗?请告诉我怎么验证,并说明这次问题的原因,我要记到踩坑笔记里。

验证通过后,把「现象 → 原因 → 解决办法」记下来。以后同样的问题,你比 AI 还熟。

万能排查话术(直接复制)

我遇到了一个问题:

做了什么:[描述你的操作]
报错内容:[完整报错]
期望结果:[你想要的正常效果]

请按顺序做:
1. 用大白话解释这个报错
2. 给出修复方案(改哪里、怎么改、有没有风险)
3. 等我确认后再动手
4. 修好后告诉我怎么验证

什么时候该开新对话

出现下面任意一种情况,直接开新对话,把「背景 + 问题」重新说一遍:

  • 对话超过十几轮,AI 开始答非所问
  • 同一个问题修了 3 次还没好
  • 你换了完全不同的任务
  • AI 反复提到旧对话里无关的内容

新对话的万能开场:

背景:我的项目在 [文件夹],是一个 [个人介绍网页],之前能正常打开。
现在的问题:[现象 + 报错]。

踩坑笔记模板

日期:
现象:
原因:
解决办法:
下次怎么预防:

积累 10 条之后,你会发现自己已经成了「会解决问题的 vibecoder」。

下一步

坑都见识过了,安全网也搭好了。最后一模块:从想法到独立完成项目。