首页 / / 第16篇

16 · 常见工作流:探索、修 Bug、重构与测试

三 · 16

探索代码库、定位修复 Bug、控制重构范围和补写测试四类高频任务的标准步骤与验收方法。

日常用 Claude Code,最频繁的无非四类活:探索、修 Bug、重构、写测试。把它们各自的标准流程记下来,能省大量时间。

「探索代码库」:接手陌生项目时,先别让它改任何东西,而是让它「读一读、讲一讲」——解释整体结构、关键模块、数据流。这一步纯读,目标是快速建立理解。

「修 Bug」:标准动作是「先复现、再定位、后修复、终验证」。让它先确认问题能复现,再找根因,再动手改,改完一定跑测试验证。图快跳过「复现」和「验证」,结果往往是改完引入新问题。

「重构」:最怕「牵一发动全身」,所以关键是「控制范围」和「小步走」。一次只重构一个点,每步都验证没破坏原有行为。让它先说清重构计划、再动手,比直接改安全得多。

「补写测试」:先让它理解这段代码的输入输出和边界情况,再生成覆盖主要路径的测试,写完跑一遍,确认测试本身是绿的、且真的测到了东西。

这四类活有个共同点:都强调「先理解、再动手、后验证」。Claude Code 不是让你完全撒手,而是让你从「亲手写每一行」变成「指挥它写、然后你审」。

每类也有各自的「验收标准」:探索要「讲得清楚」,修 Bug 要「问题不再现」,重构要「行为不变」,写测试要「覆盖到位且通过」。心里有这把尺子,你才能判断它干没干好。

常见误区:很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」,理解了动机,规则就自然内化了,不用死记硬背。

动手试一下:你可以花 5 分钟做一个最小验证——找一个真实的代码任务,让 Codex 跑一遍,看它的行为是不是和这一篇描述的一致。理论与实践对照,才知道「懂」和「会用」是两件事。

与其他篇的关系:这一篇是本组的基础。如果你跳过了前面几篇,建议先回去看,否则这里有些概念可能看着突兀。如果都看过了,那你可以直接进入更后面的实战环节,把这里学到的东西用上。

判断决策树:用三个问题判断该不该用——① 这件事值不值得用 Codex 做?② 用的话该用哪个入口?③ 风险高不高需不需要审批?三个问题的答案一出来,怎么做就清楚了。

本教程为原创内容,共 53 篇,覆盖 Claude Code 从入门到高级实战的完整路径。可随时从顶部导航返回目录,或用左侧目录跳转其他章节。