B. 常见错误与“问 AI”流程
基础版最推荐的排错方式，不是你自己先乱改，而是先把现象说清，再让 AI 帮你收窄范围。这一页整理的是最常见的几类卡点。
通用提问骨架
不管你遇到哪一类问题，都可以先用这个骨架：
text
我现在遇到的问题是：______
现象：______
我刚刚做了什么：______
我原本期望发生什么：______
如果有报错，这是完整报错：
______
请先帮我判断最可能的原因，再告诉我下一步只先检查什么。1. 页面空白 / 打不开
| 先看什么 | 怎么问 AI | 常见修复方向 |
|---|---|---|
| 是本地还是线上 | 页面空白，没有正常渲染，请先判断是启动失败、路由问题还是运行时报错 | 依赖没装好、启动命令不对、运行时报错、部署后构建失败 |
补充信息时，优先给：
- 页面截图
- 浏览器里看到的提示
- 终端完整报错
2. 按钮没反应 / 链接不能跳
| 先看什么 | 怎么问 AI | 常见修复方向 |
|---|---|---|
| 是视觉按钮还是真实交互 | 这个按钮看起来能点，但点击后没有任何动作，请检查它当前是不是只有样式，没有绑定真实跳转或事件 | 只是占位按钮、没有绑定事件、链接地址没接上、交互逻辑没完成 |
这类问题在第 1 章和第 4 章特别常见，尤其是平台先生成了一版“看起来像成品”的页面时。
3. 聊天区不回复 / 回复异常
| 先看什么 | 怎么问 AI | 常见修复方向 |
|---|---|---|
| 是占位演示还是真实调用 | 请先确认当前聊天区是关键词演示、假数据回复，还是真实接入了模型接口 | 还没接 API、环境变量没配、接口请求失败、说明书边界不清 |
如果聊天区已经能回复，但内容不对，可以继续补一句：
text
现在聊天能回复，但回答经常答偏 / 很机械。
请先不要改前端布局，先检查数字分身说明书和上下文是否缺信息。4. 本地运行失败 / 构建失败
| 先看什么 | 怎么问 AI | 常见修复方向 |
|---|---|---|
| 完整日志 | 这是我运行 / 构建时的完整报错，请先判断最可能是哪一层出了问题，再告诉我下一步只改什么 | 缺依赖、命令不对、Node 版本不兼容、配置文件有误、环境变量缺失 |
这类问题最重要的是：不要只说“报错了”。把完整日志贴出去，AI 才更容易帮你快速定位。
5. 部署失败 / 线上和本地不一致
| 先看什么 | 怎么问 AI | 常见修复方向 |
|---|---|---|
| 部署日志、环境变量、线上现象 | 这是部署平台的日志。请先判断是构建命令、环境变量，还是平台配置的问题 | 构建命令不对、环境变量漏配、线上资源路径不对、平台默认配置不匹配 |
这类问题在第 6 章最常见。部署成功之前，先看日志；部署成功之后，再看真实链接里是否还有样式或聊天问题。
一个很重要的排错原则
一次只改一个变量。
不要一看到问题，就同时改模型、改提示词、改布局、改接口、改环境变量。更稳的方式是：先判断更像哪一层的问题，再从那一层开始查。这样你更容易知道，到底是哪一步真的起了作用。