在讲具体的 bug 之前，先搞清楚你的项目由哪几部分组成。

大部分 Vibe Coding 项目，不外乎三个部分：

• 前端页面 — 你在浏览器里看到的界面
• 后端服务 — 在背后处理逻辑、接收请求
• 数据库 — 负责把数据存下来

不是所有项目都有这三层，但大体就是这几块。项目出 bug，就是这几个地方某个环节出了问题。

接下来我们总结了最常遇到的五种 bug，从最明显到最隐蔽，一个一个来看。

现象： 浏览器直接告诉你「无法访问此网站」

去哪找线索： 看终端（Terminal）——就是你启动项目的那个黑色窗口。

一般就两种情况：

情况一：项目根本没启动

终端里没有运行任何东西，项目根本没在跑。这种算不上 bug，直接跟 AI 说「帮我启动项目的前后端服务」就行。

情况二：启动了但还是无法访问

说明服务在启动过程中报错了，终端里一般会有红色的报错信息。

怎么反馈给 AI：

• 截图浏览器「无法访问」的页面
• 把终端里的报错信息一起贴给 AI

AI 就会根据你提供的信息完成错误的修改，这种启动问题通常很快就能解决。

现象： 页面打开了，但一片空白，什么都没有。

跟「无法访问」不一样——服务是启动了的，页面也加载了，但看不到任何东西。这是前端代码报错了，导致页面没办法渲染出来。

去哪找线索： 浏览器控制台。按 F12 打开开发者工具，点到 Console 面板，白屏的情况下这里几乎一定会有红色的报错信息。

怎么反馈给 AI：

• 白屏不需要截图，截下来也就是一张空白页面
• 直接告诉 AI「页面目前是空白的」
• 关键是把 Console 里的红色报错全部复制，一起发给 AI

AI 看了之后就能定位到问题，帮你修复。

现象： 页面内容出来了，但布局全崩了——按钮跑到下面去了，页面撑得特别宽，或者元素挤在一起。

这种跟白屏不一样——页面能渲染出来，只是样式出了问题。而且比较特殊：它不会报错，是纯视觉问题，你不需要去任何地方找报错信息。

怎么反馈给 AI： 需要两个东西：

1. 截图当前错乱的样子
2. 描述「应该长什么样」

让 AI 看到差距就够了。

比如你可以这样说：

页面样式错乱了，输入框和按钮应该在同一行，页面宽度应该居中显示，请帮我修复。

现象： 页面看着完全正常，但点按钮没反应。

这种比前面几种都有迷惑性——界面看着好好的，但就是不干活。问题可能出在前端（按钮交互没绑上），也可能出在后端（请求发出去了但没处理）。

去哪找线索： 两个地方：

1. Console — 点击按钮时看有没有报错
2. Network 面板 — 看点击后有没有请求发出去

判断逻辑：

• Console 没报错 + Network 没请求 → 按钮的点击事件根本没绑定上去
• Console 有报错 → 前端代码有问题
• Network 有请求但失败 → 后端有问题

怎么反馈给 AI：

• 描述「点了哪个按钮、期望什么、实际没反应」
• Console 截图 + Network 截图，一起给 AI

现象： 操作看似「成功」了，但刷新后数据消失——最隐蔽的一类 bug。

表面上看起来完全没问题，页面没报错，操作也有反馈，你甚至以为一切正常。直到刷新那一下，才发现数据根本没存下来。

去哪找线索： 两个地方：

1. Network 面板 — 看提交数据的请求，返回的状态码和内容
2. 终端 — 看后端有没有报错

关键判断： POST 返回 200 但数据没存下来 → 问题出在后端，请求收到了但没有真正写入数据库。

怎么反馈给 AI：

• 描述你的操作流程（做了什么、看到什么、刷新后怎样）
• Network 的请求截图
• 如果终端有报错也一起贴上

五种常见的讲完了，但如果你遇到的 bug 不在上面这几种里怎么办？

万能公式： 不管什么 bug，都可以用这三句话描述清楚：

我在做什么 + 我期望什么 + 实际发生了什么

通用提示词模板

我在 [做了什么操作] 的时候，期望 [应该出现什么结果]，
但实际 [出现了什么现象]。
请你先帮我分析一下问题可能出在哪，列出你的排查思路，
等我确认后再开始修复。

关键一招： 让 AI 先诊断再动手，不要让它上来就改代码。先让它列出排查思路，你确认方向对了再改。

虽然这种方式需要 AI 多查一步，但比直接说「有个 bug 帮我修一下」要快得多。

你看到的现象	去哪找线索	给 AI 什么
无法访问	终端	终端报错截图
白屏	F12 Console	Console 红色报错
样式错乱	不用找	错乱截图 + 期望描述
按钮点不动	Console + Network	两处截图
数据没保存	Network + 终端	请求截图 + 后端报错
其他情况	万能公式	做了什么 + 期望什么 + 实际什么

记住核心流程： 看现象 → 找线索 → 喂给 AI

bug 不可怕，可怕的是你不知道该给 AI 看什么。记住这张表，以后遇到 bug 先看现象、再找线索、最后喂给 AI，问题基本都能搞定。