VibeCraft Vibe Coding 实战指南
根因分析 堆栈读法 代码瘦身

高效排错、日志阅读与代码重构方法论

Vibe Coding 效率拉不开差距时,往往卡在调试阶段:普通人把半句报错来回粘贴 10 次;高手懂得喂准日志、隔离变量、该回滚时果断回滚。

1. 报错堆栈(Stack Trace)应该看哪一行?

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. 打破“越改越烂”的三步法

  1. 禁止连续试探性乱改:如果 AI 改了两次还没好,立刻叫停,要求它先输出诊断脚本打印出真实中间变量值。
  2. 最小隔离复现:把报错的那段逻辑抽到 15 行独立测试脚本里单独跑,排除前端状态、缓存、热重载等干扰因素。
  3. 果断回退 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)。