---
title: "B. 常见错误与“问 AI”流程"
order: 2
---

# B. 常见错误与“问 AI”流程

基础版最推荐的排错方式，不是你自己先乱改，而是先把现象说清，再让 AI 帮你收窄范围。这一页整理的是最常见的几类卡点。

## 通用提问骨架

不管你遇到哪一类问题，都可以先用这个骨架：

```text
我现在遇到的问题是：______

现象：______
我刚刚做了什么：______
我原本期望发生什么：______

如果有报错，这是完整报错：
______

请先帮我判断最可能的原因，再告诉我下一步只先检查什么。
```

## 1. 页面空白 / 打不开

| 先看什么 | 怎么问 AI | 常见修复方向 |
|------|-----------|--------------|
| 是本地还是线上 | 页面空白，没有正常渲染，请先判断是启动失败、路由问题还是运行时报错 | 依赖没装好、启动命令不对、运行时报错、部署后构建失败 |

补充信息时，优先给：

- 页面截图
- 浏览器里看到的提示
- 终端完整报错

## 2. 按钮没反应 / 链接不能跳

| 先看什么 | 怎么问 AI | 常见修复方向 |
|------|-----------|--------------|
| 是视觉按钮还是真实交互 | 这个按钮看起来能点，但点击后没有任何动作，请检查它当前是不是只有样式，没有绑定真实跳转或事件 | 只是占位按钮、没有绑定事件、链接地址没接上、交互逻辑没完成 |

这类问题在第 1 章和第 4 章特别常见，尤其是平台先生成了一版“看起来像成品”的页面时。

## 3. 聊天区不回复 / 回复异常

| 先看什么 | 怎么问 AI | 常见修复方向 |
|------|-----------|--------------|
| 是占位演示还是真实调用 | 请先确认当前聊天区是关键词演示、假数据回复，还是真实接入了模型接口 | 还没接 API、环境变量没配、接口请求失败、说明书边界不清 |

如果聊天区已经能回复，但内容不对，可以继续补一句：

```text
现在聊天能回复，但回答经常答偏 / 很机械。
请先不要改前端布局，先检查数字分身说明书和上下文是否缺信息。
```

## 4. 本地运行失败 / 构建失败

| 先看什么 | 怎么问 AI | 常见修复方向 |
|------|-----------|--------------|
| 完整日志 | 这是我运行 / 构建时的完整报错，请先判断最可能是哪一层出了问题，再告诉我下一步只改什么 | 缺依赖、命令不对、Node 版本不兼容、配置文件有误、环境变量缺失 |

这类问题最重要的是：**不要只说“报错了”**。把完整日志贴出去，AI 才更容易帮你快速定位。

## 5. 部署失败 / 线上和本地不一致

| 先看什么 | 怎么问 AI | 常见修复方向 |
|------|-----------|--------------|
| 部署日志、环境变量、线上现象 | 这是部署平台的日志。请先判断是构建命令、环境变量，还是平台配置的问题 | 构建命令不对、环境变量漏配、线上资源路径不对、平台默认配置不匹配 |

这类问题在第 6 章最常见。部署成功之前，先看日志；部署成功之后，再看真实链接里是否还有样式或聊天问题。

## 一个很重要的排错原则

一次只改一个变量。

不要一看到问题，就同时改模型、改提示词、改布局、改接口、改环境变量。更稳的方式是：先判断更像哪一层的问题，再从那一层开始查。这样你更容易知道，到底是哪一步真的起了作用。