6.11操作⏱ 约 5 分钟

用 Claude 调试

把报错丢给它,但你来引导

🔎 最后验证 2026-05📚 来源:《AI编程实战三卷书》卷二、Claude Code 官方文档🧰 Claude Code✅ 145 人学过👁 283 次阅读

为什么学这个

代码出 bug 是常态。好消息:调试是 Claude 最擅长的事之一——你把报错给它,它能顺着代码找到根源并修好。但要它修得准,你得会"喂"对信息。

💡 打个比方

这就像看医生:你说"我不舒服"远不如说清"哪疼、什么时候开始、做了什么会加重"。给 Claude 调 bug 也一样——症状描述得越具体,它越能直击病根,而不是开一堆没用的药。

调试给 Claude 的"三件套",喂得越全修得越准:
1. 完整报错:把终端/控制台的报错原文贴给它(别只说"报错了")
2. 复现步骤:"我点了提交按钮,就出现这个"
3. 环境信息:操作系统、版本等(还记得 P2 的'环境'吗)
让它先定位再动手:"先告诉我你认为问题出在哪、为什么",你认可了再让它改
修完依然要审查(git diff)+ 验证(真的不报错了吗)

示例:把报错交给 Claude示例 · 非实时

你

页面点'添加'按钮没反应。控制台报错:Uncaught TypeError: Cannot read properties of null (reading 'addEventListener')。

Claude Code

这通常是脚本在元素加载前就运行了。我看一下 app.js 里获取按钮的时机。

⚙ 读取 app.js

Claude Code

确认了:script 在 <head> 里、按钮还没渲染就执行。我把脚本移到 body 末尾,或加 DOMContentLoaded。改哪种?

这是示意性的会话片段,帮助你了解真实 Claude Code 大致的交互方式。实际回应会因项目和版本而不同——一切以你在真实终端里看到的为准。

❓ 测验

让 Claude 帮你调 bug,最该提供的是?

⚠️ 避坑别让它'盲目试错',要它先讲清因果

有时 Claude 会不解释就一通乱改,改完没好又改别处,越改越乱。要求它先说'问题根源是什么、为什么这么改',你判断合理再动手。理解原因比'碰巧修好'重要——否则同类 bug 还会再来。

🤖 调试提示词模板(收藏)

我遇到一个 bug。报错原文:【粘贴完整报错】。复现步骤:【怎么触发的】。我的环境:【系统/版本】。请先分析问题最可能的根源(先别改代码),告诉我你的判断和理由,我确认后你再修。

🔎 来源与核验· 1 条,点开核对

本节每个关键论断都对应一个可追溯的来源 —— 这是本课程"靠谱、不过时"的底线。

「提供完整报错、复现步骤与环境信息,能显著提升 AI 调试的准确性」

✅ 小结

你会和 AI 一起调 bug 了。把前面所有习惯(改前提交、改后 diff、审查)固化成一套流程,就是和 AI 协作的"标准工作流"。下一节把它和 Git 串起来。

下一节 → 配合 Claude 的 Git 工作流

都看到这了，打个赏呗！