2.5 高效调试心法 🟢 转载

来源:https://github.com/datawhalechina/vibe-vibe

阅读完本节后,你将会收获:

  • 掌握高效的 AI 调试沟通公式
  • 学会如何提供完整的错误日志和上下文
  • 理解循环修复模式,持续迭代直到问题解决
  • 了解"让 AI 自己 build"的终极大招

序言中提到的"调试心法":提供完整报错日志和循环修复模式。

前置知识

💡 什么是 调试

调试(Debug)是发现并修复代码错误的过程。

💡 什么是 错误日志

错误日志(Error Log)是程序崩溃或异常时输出的详细信息,包含错误类型、位置、堆栈等。

💡 什么是 堆栈

堆栈(Stack Trace)是错误发生时的函数调用链,显示错误是从哪一行代码、哪个函数、一层层调用产生的。它能帮你追溯错误的源头。

终极大招:让 AI 自己 Build

场景:报错一堆,你不想逐个排查

你改了代码,构建失败。错误信息 50 行,不知道从哪开始。

直接甩给 AI

"请帮我运行 pnpm install && pnpm build,如果遇到错误请自行修复,直到构建成功"

然后你去喝杯咖啡

为什么有效

  • AI 直接看到真实错误,不用你转述
  • 小问题(版本冲突、缺失依赖)AI 自己解决
  • 你看结果就行

适用场景

场景 为什么适合
接手新项目 不知道项目结构,让 AI 自己探索
报错太多 逐个排查太慢,让 AI 并行处理
CI/CD 挂了 本地复现不了,让 AI 在本地跑

注意事项

  • ✅ 先 git commit,AI 改坏能回滚
  • ✅ 第一次可能慢,耐心等待
  • ⚠️ AI 陷入死循环(来回改同一处)→ 及时打断

案例 2:运行时错误

错误日志

Error: connect ECONNREFUSED 127.0.0.1:5432
    at Connection.<anonymous> (node_modules/pg/lib/client.js:89:17)
    at Socket.emit (events.js:315:13)

❌ 错误描述

"数据库连接失败"

✅ 正确描述

数据库连接错误:

错误: connect ECONNREFUSED 127.0.0.1:5432

环境:
- 开发环境
- PostgreSQL 应该在本地运行
- .env 中 DATABASE_URL="postgresql://localhost:5432/mydb"

可能的原因:
1. PostgreSQL 没有启动?
2. 端口不对?
3. .env 配置错误?

AI 分析

ECONNREFUSED 表示服务未运行。
检查:
1. PostgreSQL 是否启动
2. 端口是否正确(默认 5432)
3. 运行命令检查:
   Mac/Linux: brew services list
   Windows: sc query postgresql-x64-[version]

常见错误模式速查

错误类型 典型信息 解决方向
类型错误 Type 'X' is not assignable to type 'Y' 检查类型定义,使用类型断言或修改类型
空值错误 Cannot read property 'X' of undefined 添加空值检查、可选链、默认值
导入错误 Module not found: Can't resolve 'X' 安装依赖、修正路径、检查导出
网络错误 ECONNREFUSED / ENOTFOUND 检查服务状态、URL、网络连接
端口占用 Address already in use :3000 关闭占用端口的进程或换端口
权限错误 EACCES / Permission denied 检查文件权限,使用 sudo 或更改权限
语法错误 Unexpected token / SyntaxError 检查语法拼写,注意括号引号匹配

相关内容

  • 前置:2.2 VibeCoding工作流详解
最后编辑:Alex 2026-03-05 11:39:51