常见错误怎么排查？

04-02 常见错误怎么排查？

课程定位

这一课建立基本排错路线。上一课学员已经知道如何把完整现场交给 AI，现在要认识几个最常见的错误类型。

新手排错不需要记住所有技术细节，先学会按路线检查：目录、路径、保存、依赖、端口、缓存、语法。

这一课的成果是一张「常见错误排查表」。

本课目标

能识别 7 类常见错误。
能根据现象选择第一步检查。
能让 AI 按排查路线逐项确认。
能记录错误原因和修复动作。
能减少重复踩坑。

录制建议

建议时长：25 到 35 分钟。
每类错误给一个生活比喻和一个屏幕例子。
不展开复杂技术原理，先讲现象和第一步。
用“排查顺序”给学员稳定感。
收尾保存常见错误排查表。

课前准备

一个可以制造简单错误的项目。
报错协作卡。
常见错误排查表。
AI 工作台工具。

讲稿正文

可以这样开场：

“很多报错看起来吓人，背后常常是几个很朴素的问题：站错房间、找错文件、忘记保存、缺了材料、门口被占、浏览器记住了旧页面、代码里少了符号。”

常见错误有七类。

第一，文件路径错误。

现象：图片不显示、文件找不到、输出没生成到预期位置。第一步检查文件是否真的在那个位置。

第二，文件保存位置错误。

现象：改了文件，页面没变化。第一步检查当前修改的文件是否就是项目里的那份文件，并确认保存。

第三，命令运行目录错误。

现象：终端提示找不到文件或找不到项目配置。第一步检查当前目录。

第四，依赖未安装。

现象：Node 或 Python 项目提示缺少某个包。第一步把完整报错交给 AI，让它判断需要安装什么。

第五，端口被占用。

现象：本地服务启动失败，提示某个端口已经在使用。第一步让 AI 判断是否换端口或停止旧服务。

第六，浏览器缓存。

现象：文件已保存，页面仍显示旧版本。第一步刷新、强制刷新或重新打开页面。

第七，语法错误。

现象：页面空白、终端指向某一行代码、括号或引号附近报错。第一步把报错行和相关文件交给 AI。

排查顺序建议：

先看目录 -> 再看文件 -> 再看保存 -> 再看命令 -> 再看依赖 -> 再看端口 -> 最后看代码语法

最后收束：

“排错要按线索来。像查水管漏点，一段一段看，线索会自己浮出来。”

屏幕演示流程

展示一个页面没变化的场景。
按顺序检查是否保存。
检查是否打开正确文件。
展示一个命令目录错误。
让 AI 判断错误类型。
选择一个最小检查动作。
把错误类型和修复动作写进排查表。

给 AI 的协作卡

请根据我的报错协作卡，帮我判断这属于哪类常见错误：
1. 文件路径错误
2. 文件保存位置错误
3. 命令运行目录错误
4. 依赖未安装
5. 端口被占用
6. 浏览器缓存
7. 语法错误

请先说明判断依据，再给出第一步检查动作。
一次只给一个最小动作。

常见错误排查表

错误现象：
AI 判断类型：
判断依据：
第一检查动作：
检查结果：
修复动作：
下次预防：

课堂练习

给学员 2 个模拟报错，让他们填写排查表。

要求：

每个报错只选一个最可能类型。
写出第一步检查动作。
让 AI 给判断依据。

常见卡点

学员直接怀疑代码坏了：先查目录、文件和保存。
AI 一次给太多修法：要求它按排查顺序来。
学员看不懂英文报错：让 AI 翻译成错误类型和下一步动作。
反复遇到同一类错误：写入 logs，形成个人排错库。

课后作业

为主项目整理一张常见错误排查表。

提交内容：

至少 2 个错误现象。
AI 的错误类型判断。
修复动作和下次预防。

课件页建议

第 1 页：报错背后常见的七类问题
第 2 页：目录、路径、保存、依赖、端口、缓存、语法
第 3 页：排查顺序
第 4 页：模拟报错练习
第 5 页：常见错误排查表