基础代码理解

面对陌生的代码库，Claude Code 能帮你快速建立认知——从整体架构到具体实现，从函数功能到潜在问题。

理解单个文件

最直接的用法：把文件交给 Claude Code，让它解释。

> 帮我解释 src/auth/tokenManager.ts 这个文件做了什么

Claude Code 会先读取文件，然后给出解释——包括主要功能、关键函数的作用，以及和其他模块的关系。

如果你想要更具体的说明：

> 解释这个文件时重点说：
> 1. 核心数据结构是什么
> 2. 主要的函数有哪些，各自做什么
> 3. 有什么需要注意的地方（安全、性能、依赖等）

---

理解特定函数或代码段

不需要理解整个文件，只关注某个部分：

> 解释 parseJWT 函数是怎么工作的，特别是 payload 验证那部分

> 这段代码里的 reduce 在做什么？用通俗的语言解释：

const result = items.reduce((acc, item) => {
  const key = item.category;
  if (!acc[key]) acc[key] = [];
  acc[key].push(item);
  return acc;
}, {});

---

追踪代码执行流程

理解”这个请求从进来到处理完经历了什么”：

> 用户调用 POST /api/orders 后，代码是怎么执行的？
> 从路由入口开始，追踪完整的调用链

> 当这个 React 组件的 submit 按钮被点击时，发生了什么？
> 追踪从事件触发到数据最终保存的完整流程

Claude Code 会读取相关文件，梳理调用链，告诉你每一步发生了什么。

---

理解项目整体结构

接手新项目时，快速建立全局认知：

> 给我一个这个项目的整体概览：
> - 这个项目是做什么的
> - 主要的目录结构和每部分的作用
> - 核心的技术选型
> - 数据是怎么流动的（从用户操作到数据存储）

> 这是一个 monorepo，帮我理解：
> - packages/ 里各个包的作用
> - 包之间的依赖关系
> - 如何运行和开发

---

理解复杂逻辑

遇到看不懂的复杂实现：

算法和数据处理

> 解释 src/utils/cache.ts 里的 LRU 缓存实现
> 重点说清楚：淘汰机制是怎么实现的，为什么这样实现

> 这个正则表达式是什么意思？
> /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/

并发和异步

> src/workers/jobQueue.ts 里的并发控制是怎么实现的？
> 为什么要用 Semaphore？不用会怎样？

状态管理

> 帮我理解 Redux store 的结构：
> - 有哪些 slice
> - 数据是怎么组织的
> - 哪些操作会触发状态更新

---

找到关键代码位置

不知道某个功能在哪里实现：

> 用户登录失败后会被锁定账户，这个逻辑在哪里实现的？

> 订单状态是怎么管理的？
> 状态变更的规则在哪里定义，谁负责触发状态变更？

> 这个项目是怎么处理数据库连接的？连接池在哪里配置？

Claude Code 会搜索代码库，找到相关文件和代码段，给你指出来。

---

理解配置文件

各种配置文件经常让人看不懂：

> 解释 webpack.config.js 的关键配置：
> - entry 和 output 是怎么配置的
> - 有哪些 loader 和 plugin，各自的作用
> - 开发环境和生产环境有什么区别

> .eslintrc.json 里的规则是什么意思？
> 有哪些是项目自定义的，有什么特别的考虑？

---

理解第三方库的用法

项目用了不熟悉的库：

> 项目里用了 Zod 做数据验证，帮我解释：
> - 在项目里是怎么使用的（看 src/schemas/ 目录）
> - 和 TypeScript 类型是什么关系
> - 验证失败时是怎么处理的

> 项目用了 Bull 做任务队列，帮我看看 src/queues/ 目录：
> - 有哪些队列，各自处理什么
> - 任务是怎么添加进去的
> - 失败重试是怎么配置的

---

提问技巧

从整体到局部

先问整体，再深入细节：

> 先给我这个模块的整体介绍
# 看完后...
> 重点解释 refreshToken 那部分

对比理解

> 这个项目有两种处理错误的方式，一个在 middleware/，一个在 services/ 里
> 它们有什么区别？什么情况下用哪种？

验证理解

> 我理解这个函数是这样工作的：[你的理解]
> 我说的对吗？有没有我遗漏的重要细节？

问”为什么”

> 为什么要用 WeakMap 而不是普通 Map 来存储这个缓存？
> 这个设计解决了什么问题？

---

建立代码阅读节奏

接手陌生项目的推荐顺序：

1. 全局概览：项目结构、README、主入口文件
2. 核心流程：主要的用户流程和数据流
3. 关键模块：认证、数据库、API 层等核心模块
4. 具体实现：遇到具体问题时再深入
5. 边跑边看：启动项目，边操作边对应代码

不需要把整个项目看完再开始工作，按需深入效率更高。