冷蟊初退 孤灯野澜 志起鸡鸣 墓不悲秋 技术交流 软件开发 商业合作 加Q:411239339

Day 2 三板斧:读代码、改代码、问问题

浏览:10次阅读
没有评论

共计 2606 个字符,预计需要花费 7 分钟才能阅读完成。

Claude Code 从入门到脱发 · Day 2

昨天我们把 Claude Code 装好了,也跟它打了个招呼。今天正式开工——学会它最基础也最实用的三个能力:读代码、改代码、问问题。

这三招听起来朴素,但用好了能覆盖你日常 80% 的开发场景。毕竟大多数时候我们不是在写全新的代码,而是在理解别人的代码、修改已有的代码、搞清楚某段逻辑到底在干什么。

本文你将学到:

  • 如何让 Claude Code 帮你读懂陌生代码
  • 如何精准指示它修改代码
  • 提问的技巧:什么样的问题能得到好答案
  • Plan Mode 的正确用法

阅读时间 :8 分钟 | 实操时间 :20 分钟 | 难度:入门


第一斧:读代码

接手一个新项目,最痛苦的事情是什么?读代码。几万行代码,文档缺失或过时,变量名缩写到你怀疑人生。这是 Claude Code 最擅长的事情之一。

项目全局概览

> 帮我梳理一下这个项目的整体架构,包括目录结构、技术栈、入口文件

Claude Code 会自动扫描项目文件,给你一份结构化的概览。

理解特定文件

> 读一下 src/services/auth.ts,解释它的核心逻辑

注意,你可以直接给文件路径。Claude Code 支持 Tab 补全,敲几个字母按 Tab 就能自动补全路径,非常方便。

追踪调用链

> 用户点击 "登录" 按钮后,代码的执行流程是怎样的?从前端到后端帮我理一遍

这种跨文件的调用追踪,人工做起来得翻好几个文件,Claude Code 几秒钟就能给你画出来。

小技巧:给它一个 URL

Claude Code 能读取 URL 内容。如果你要修复一个 GitHub Issue:

> 看一下这个 issue https://github.com/xxx/yyy/issues/123,分析一下问题原因

它会去读 Issue 内容,然后结合你的代码给出分析。


第二斧:改代码

这是 Claude Code 跟纯聊天 AI 拉开差距的地方——它真的能改你的文件。

简单修改

> 把 src/config.ts 里的 API_URL 从 localhost 改成 api.example.com

Claude Code 会展示 diff(差异对比),等你确认后修改文件。

功能添加

> 给 UserService 加一个 deleteUser 方法,参数是 userId,需要先检查用户是否存在

它会读取现有的 UserService 代码,理解已有的模式和风格,然后按照同样的方式添加新方法。

Bug 修复

> 运行 npm test 之后有个测试失败了,帮我看看哪里出了问题并修复

它会运行测试、读取错误信息、定位问题代码、修复,然后再运行一次测试验证。这整个流程它一气呵成。

重构

> 把这个 500 行的 utils.ts 按功能拆分成多个小文件

Claude Code 会分析文件里的函数,按功能分组,创建新文件,更新所有 import 引用。

改代码的黄金法则

这里有个很重要的经验:指令要具体。

不好的指令:

> 优化一下这个项目

好的指令:

> src/utils/date.ts 里的 formatDate 函数不支持时区,请添加一个可选的 timezone 参数,默认使用 UTC

越具体,结果越准确。含糊的指令会让 Claude Code 发挥想象力,而 AI 的想象力有时候比你的发际线还不受控制。


第三斧:问问题

Claude Code 不仅能改代码,也是个很好的技术顾问。它能结合你的项目上下文回答问题,比在 Google 里搜强多了。

问架构决策

> 这个项目用 Redux 做状态管理,如果要迁移到 Zustand,工作量大吗?需要改哪些地方?

问性能问题

> 分析一下 src/pages/Dashboard.tsx 有没有性能问题,特别是不必要的重渲染

问最佳实践

> 我这个 Express 中间件的错误处理写法对吗?有没有更好的方式?

问 Debug

> 我运行 npm start 的时候报错了,错误信息如下:> [粘贴错误信息]
> 帮我分析一下原因

Plan Mode:先想后做

Claude Code 有个特别实用的模式叫 Plan Mode。按两次 Shift+Tab 切换进去,Claude 进入 " 只读模式 "——它可以分析、思考、规划,但不会执行任何操作。

这在什么时候有用?大型改动之前。

比如你想重构认证模块,直接让 Claude Code 动手可能改出一堆问题。正确的做法是:

第一步:进入 Plan Mode

按两次 Shift+Tab,提示符会变,表示进入了规划模式。

第二步:让它规划

> 我想把用户认证从 Session 改成 JWT,帮我做一个改动计划

它会列出需要改的文件、改动顺序、潜在风险、需要注意的兼容性问题。

第三步:确认后执行

再按两次 Shift+Tab 退出 Plan Mode,然后告诉它执行计划。

这种 " 先想后做 " 的模式,能避免很多翻车事故。你不会让一个陌生人直接装修你家,你会先让他出个方案对吧?


实操练习

找一个你手头的项目,跟着做:

练习 1:读代码

> 帮我梳理这个项目的目录结构和核心文件

练习 2:问问题

> 这个项目有哪些地方的代码写得不够好?列出最严重的三个问题

练习 3:改代码

> 给 README.md 加一段 "快速开始" 的说明,包含安装和运行步骤

练习 4:Plan Mode

[Shift+Tab x2 进入 Plan Mode]
> 如果要给这个项目加单元测试,应该怎么规划?

常见问题 Q&A

Q1:Claude Code 修改文件后能撤销吗?

能。Claude Code 每次修改前会展示 diff,而且你的代码应该在 Git 管理下。最简单的撤销方式:

git checkout --    # 撤销单个文件
git stash                 # 暂存所有改动

Q2:它会不会改错文件?

Claude Code 每次修改都需要你确认。它展示要改什么,你按 y 才会执行。如果你不确定,可以按 e 在编辑器里详细看看。

Q3:上下文会不会太长导致变卡?

会。随着对话变长,Claude Code 的响应会变慢,还会自动压缩历史消息。建议每完成一个任务就 /clear 清一下上下文,保持它的头脑清醒——你自己摸鱼太久也会走神,AI 也一样。


小结

今天学了 Claude Code 的三板斧:

  • 读代码:让它帮你理解项目结构、文件逻辑、调用链
  • 改代码:指令要具体,它会展示 diff 等你确认
  • 问问题:结合项目上下文的技术咨询
  • Plan Mode:大改动前先让它出方案

这三招能覆盖日常 80% 的场景。但你很快会发现一个问题:Claude Code 虽然聪明,但它不了解你团队的代码规范,不知道你偏好的编码风格,每次都要重复交代一堆背景信息。

怎么解决?明天 Day 3,我们聊 CLAUDE.md——一个让 Claude Code " 记住你的规矩 " 的魔法文件。

明天见。


系列进度:2/10

正文完
创作不易,扫码加点动力
post-qrcode
 0
果较瘦
版权声明:本站原创文章,由 果较瘦 于2026-03-29发表,共计2606字。
转载说明:除特殊说明外本站文章皆由果较瘦原创发布,转载请注明出处。