高效排错、日志阅读与代码重构方法论
Vibe Coding 效率拉不开差距时,往往卡在调试阶段:普通人把半句报错来回粘贴 10 次;高手懂得喂准日志、隔离变量、该回滚时果断回滚。
1. 报错堆栈(Stack Trace)应该看哪一行?
- Python 报错(从下往上看):最底部最后一行是错误类型和直接原因(如
KeyError: 'user_id');往上找第一条属于你自己项目文件(而不是site-packages/第三方库)的文件名和行号,那里才是案发现场。 - JavaScript / TypeScript 报错(从上往下看):第一行通常是核心报错,往下紧跟着的第一条
src/...路径就是出错位置。 - 浏览器接口异常(F12 → Network 面板):不要只截图页面弹出的“请求失败”,点开 F12 Network 里变红的那一条请求,把 Status Code(400/401/404/500)+ Request Payload + Response 原文 一起发给 AI,几乎一枪命中。
2. 常见状态码秒级定位表
| HTTP 状态码 | 真实含义 | 第一排查方向 |
|---|---|---|
400 / 422 | 参数校验不通过 | 前端发过去的字段名、类型(字符串 vs 数字)和后端 Schema 对不上 |
401 / 403 | 未登录或权限不足 | Cookie/Header 没带过去(常见忘记配 credentials: 'include')或跨域丢失 |
404 | 路由不存在 | 前端多了或少了 /api 前缀,或者 Nginx proxy_pass 末尾斜杠写错 |
500 | 后端代码崩了 | 别问前端,直接去后端终端或 journalctl / docker logs 看红色 Traceback |
502 / 504 | 网关找不到后端或超时 | 后端进程没启动、端口绑错,或者某次 AI/外部请求卡死超时 |
3. 打破“越改越烂”的三步法
- 禁止连续试探性乱改:如果 AI 改了两次还没好,立刻叫停,要求它先输出诊断脚本打印出真实中间变量值。
- 最小隔离复现:把报错的那段逻辑抽到 15 行独立测试脚本里单独跑,排除前端状态、缓存、热重载等干扰因素。
- 果断回退 Git:只要感觉 AI 已经开始胡乱加
try/except掩盖异常,立刻git reset --hard HEAD回到上一步干净代码,总结刚才失败的原因后重开指令。
4. 每个功能上线前的“瘦身重构四件套”
1. 合并重复代码:两个接口都在手动解析分页参数或校验 Token?抽出一个通用依赖/中间件。
2. 消除深层嵌套:把 if-else 嵌 5 层的写法改成开头判断异常直接 return / raise。
3. 清理死代码:删掉注释掉的老代码块、未使用的 import、测试用的 print/console.log。
4. 统一魔法数字:把 86400、100、5000 这类散落数字定义成具名常量(如 CACHE_TTL_SEC)。