阅读完本节后,你将会收获:
- 掌握高效的 AI 调试沟通公式
- 学会如何提供完整的错误日志和上下文
- 理解循环修复模式,持续迭代直到问题解决
- 了解"让 AI 自己 build"的终极大招
序言中提到的"调试心法":提供完整报错日志和循环修复模式。
调试(Debug)是发现并修复代码错误的过程。
错误日志(Error Log)是程序崩溃或异常时输出的详细信息,包含错误类型、位置、堆栈等。
堆栈(Stack Trace)是错误发生时的函数调用链,显示错误是从哪一行代码、哪个函数、一层层调用产生的。它能帮你追溯错误的源头。
场景:报错一堆,你不想逐个排查
你改了代码,构建失败。错误信息 50 行,不知道从哪开始。
直接甩给 AI:
"请帮我运行 pnpm install && pnpm build,如果遇到错误请自行修复,直到构建成功"
然后你去喝杯咖啡。
为什么有效:
适用场景:
| 场景 | 为什么适合 |
|---|---|
| 接手新项目 | 不知道项目结构,让 AI 自己探索 |
| 报错太多 | 逐个排查太慢,让 AI 并行处理 |
| CI/CD 挂了 | 本地复现不了,让 AI 在本地跑 |
注意事项:
git commit,AI 改坏能回滚错误日志:
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 |
检查语法拼写,注意括号引号匹配 |