## 前言：为什么需要这篇教程？

上篇介绍了 Claude Code 的基础操作，这篇我们聚焦**实战场景**和**效率倍增技巧**，帮助你真正把 Claude Code 变成日常开发的得力助手。

---

## 一、工作流集成：让 Claude Code 融入你的开发习惯

### 1.1 与 VSCode 配合使用

```bash
# 在 VSCode 终端中直接使用
# 打开终端 (Ctrl+`)

claude

# 一边写代码，一边与 Claude 讨论
# 修改后直接在 VSCode 中保存，Claude Code 会自动感知文件变化
```

**技巧**：使用 VSCode 的终端分屏，左边编辑器，右边 Claude Code，效率翻倍。

### 1.2 与 Git Workflow 集成

```bash
# 创建新分支前的调研
> 分析当前 main 分支的代码，评估重构方案

# 开发完成后
> 帮我写个 squash commit message，格式：
> feat(scope): 简短描述
> 
> 详细说明...

# PR 准备
> 总结本次改动的要点，生成 PR 描述
> 检查是否有遗漏的边界情况
```

### 1.3 与 CI/CD 结合

```bash
# 分析构建失败
> 读取 .github/workflows/ci.yml，分析测试失败原因
> 运行 lint，帮我自动修复能修复的问题

# 部署前检查
> 检查环境变量是否都正确配置
> 验证数据库迁移脚本的安全性
```

---

## 二、项目初始化与脚手架

### 2.1 快速搭建项目骨架

```bash
mkdir my-awesome-project
cd my-awesome-project
claude

> 创建一个 TypeScript Node.js 项目，包含：
> - ESLint + Prettier 配置
> - Jest 测试框架
> - tsconfig.json（严格模式）
> - 一个简单的 src/index.ts 示例
> - 对应的测试文件

> 生成 package.json，包含以下脚本：
> dev, build, test, lint, type-check
```

### 2.2 从零实现功能模块

```bash
> 实现一个用户认证模块，要求：
> 1. 使用 JWT
> 2. 支持 refresh token
> 3. 密码 bcrypt 加密
> 4. 包含登录、注册、登出、刷新 token 接口
> 5. 使用 Express 框架
> 6. 添加请求验证（使用 zod）
> 
> 请先生成架构设计，确认后再实现
```

---

## 三、调试与排错：把 Claude Code 当高级调试器

### 3.1 分析运行时错误

```bash
# 把错误日志直接贴给 Claude
> 程序报错了：
> TypeError: Cannot read property 'map' of undefined
> at processData (/app/src/utils.js:45:23)
> 
> 结合 src/utils.js 分析可能的原因

# 生产环境问题排查
> 查看 error.log，分析为什么内存使用持续增长
> 根据这段 heapdump 分析，找出内存泄漏点
```

### 3.2 性能分析

```bash
> 分析这个 API 响应时间 3 秒的问题：
> [粘贴代码或指定文件路径]

> 帮我找出数据库查询中的 N+1 问题

> 分析 package.json 中的依赖，找出可能过时或有安全漏洞的包
```

### 3.3 复杂逻辑验证

```bash
> 这个递归函数在某些输入下会栈溢出，帮我找出原因并优化

> 检查这个并发请求处理是否存在竞态条件

> 模拟 1000 并发请求，分析这段限流代码是否正确
```

---

## 四、代码审查与质量保障

### 4.1 自动化 Code Review

```bash
> 对比 feature/auth 分支和 main 分支的差异
> 检查：
> - 潜在的 bug
> - 性能问题
> - 安全漏洞（SQL注入、XSS等）
> - 代码规范问题
> - 测试覆盖率
> 
> 按严重程度排序输出

> 审查这次 PR，给出合并建议（批准/需要修改/拒绝）
```

### 4.2 安全审计

```bash
> 扫描整个项目，找出：
> - 硬编码的密钥或密码
> - 不安全的依赖版本
> - 危险函数使用（eval、exec等）
> - 缺少输入验证的地方
> - 敏感信息泄漏风险

> 检查这个 SQL 查询是否有注入风险
> 分析这个身份验证逻辑是否有绕过可能
```

### 4.3 测试生成与增强

```bash
> 为 src/services/payment.ts 生成完整的单元测试
> 包括：正常流程、边界情况、异常处理
> 使用 Jest 框架，覆盖率目标 90%

> 分析现有测试，找出未覆盖的代码路径

> 生成集成测试，测试用户注册到登录的完整流程
```

---

## 五、文档生成与维护

### 5.1 自动生成文档

```bash
> 为 src/api/ 下所有路由生成 API 文档
> 格式：OpenAPI 3.0
> 包含：请求参数、响应格式、错误码、示例

> 根据代码生成架构图（PlantUML 格式）

> 生成 CHANGELOG.md，基于 git log 和 commit 信息
```

### 5.2 知识库沉淀

```bash
> 总结这个项目中使用的设计模式，输出到 docs/patterns.md

> 为新人创建 onboarding 文档，包含：
> - 项目结构说明
> - 本地开发环境搭建
> - 常见开发流程
> - 常见问题排查

> 生成决策记录（ADR），记录这次架构选择的原因和权衡
```

---

## 六、多文件重构实战

### 6.1 重命名重构

```bash
> 将所有的 getUserById 函数重命名为 fetchUserById
> 影响范围：src/controllers/, src/services/, src/tests/
> 同时更新对应的测试文件和类型定义

> 确认后再执行，分批进行，每批后运行测试
```

### 6.2 提取公共逻辑

```bash
> 在以下文件中，都有重复的错误处理逻辑：
> - src/controllers/userController.js
> - src/controllers/productController.js  
> - src/controllers/orderController.js
> 
> 帮我提取到 src/middlewares/errorHandler.js
> 然后逐个文件替换为使用新的中间件
```

### 6.3 架构升级

```bash
> 将项目从 CommonJS 迁移到 ES Modules
> 步骤：
> 1. 修改 package.json 添加 "type": "module"
> 2. 将所有 require/exports 改为 import/export
> 3. 更新文件扩展名为 .mjs 或调整导入路径
> 4. 解决 __dirname 等问题
> 
> 请先生成迁移计划，每完成一个模块运行测试验证
```

---

## 七、团队协作技巧

### 7.1 统一代码风格

```bash
> 根据团队规范生成 .prettierrc 和 .eslintrc.js
> 规范要求：
> - 缩进：2 空格
> - 单引号
> - 分号：必须
> - 行宽：100
> - 尾随逗号：es5

> 批量格式化整个 src 目录
```

### 7.2 模板与脚本

```bash
> 创建一个脚本，用于生成新的 React 组件
> 模板包含：组件文件、测试文件、样式文件、index 导出
> 放在 scripts/generate-component.js

> 创建 commit-msg 钩子，自动校验 commit message 格式
> 要求符合 Conventional Commits 规范
```

### 7.3 知识共享

```bash
> 创建一个 markdown 表格，记录团队常用的 Claude Code 命令和提示语
> 输出到 .claude/team-prompts.md

> 解释项目中使用的自定义装饰器 @validate 和 @log
> 生成使用示例和最佳实践
```

---

## 八、自定义提示模板

### 8.1 创建角色提示

在 `.claude/roles/` 目录创建提示文件：

**`frontend-expert.md`**:
```
你是一个资深前端工程师，专精于 React 和 TypeScript。
回答时：
1. 优先考虑性能和可访问性
2. 使用函数式组件和 hooks
3. 提供完整的类型定义
4. 考虑边界情况
```

**`security-auditor.md`**:
```
你是一个安全专家，正在进行代码审计。
关注：
1. OWASP Top 10 漏洞
2. 认证授权问题
3. 数据验证和清理
4. 安全配置
输出格式：按风险等级排序，附修复建议
```

### 8.2 使用自定义角色

```bash
> @frontend-expert 重构这个组件，提取可复用的 hooks

> @security-auditor 检查这个支付处理代码
```

---

## 九、效率提升秘籍

### 9.1 快捷键与别名

```bash
# 在 .bashrc 或 .zshrc 中添加
alias c="claude"
alias cc="claude --continue"  # 继续上次对话
alias cr="claude --resume"    # 恢复会话

# 常用一键操作
alias cf="claude '修复所有 lint 错误'"
alias ct="claude '为暂存区文件生成测试'"
```

### 9.2 会话管理

```bash
# 保存会话
> /save session-name

# 加载会话
> /load session-name

# 查看所有会话
> /list

# 导出会话记录
> /export chat-log.md
```

### 9.3 批处理模式

```bash
# 执行命令后退出
claude --execute "运行所有测试并修复失败的用例"

# 处理多个任务
claude --batch tasks.txt

# 定时任务
0 2 * * * cd /project && claude --execute "分析昨日错误日志并生成报告"
```

---

## 十、故障排查速查表

| 问题现象 | 可能原因 | 解决方案 |
|---------|---------|---------|
| 响应缓慢 | token 过多 | 使用 `/clear` 清空上下文，或指定具体文件 |
| 代码不符合预期 | 提示词不清晰 | 提供更多示例输入/输出 |
| 无法执行命令 | 权限问题 | 检查 `autoApprove` 配置 |
| API 限额超限 | 调用频繁 | 降低请求频率，使用缓存 |
| 上下文丢失 | 切换了目录 | 重新启动并指定项目路径 |

---

## 十一、进阶示例：完整开发流程

```bash
# 1. 需求分析
claude
> 我需要实现一个文件上传功能，要求：
> - 支持图片、PDF、ZIP
> - 限制单个文件 10MB
> - 病毒扫描
> - 生成缩略图
> 请分析技术方案和风险点

# 2. 实现功能
> 按照方案 A 实现，使用 multer + sharp
> 分成 5 个小任务，每完成一个让我确认

# 3. 测试验证
> 为上传功能编写测试用例
> 运行测试，修复失败的用例

# 4. 性能优化
> 分析上传慢的原因，给出优化建议

# 5. 文档与提交
> 生成 API 文档
> 生成 commit message
> 生成 PR 描述和测试报告
```

---

## 结语：从工具到伙伴

Claude Code 不仅是执行命令的工具，更是能**理解意图、主动建议**的编程伙伴。

**记住三个核心原则**：
1. **渐进增强**：从简单任务开始，逐步提高复杂度
2. **人机协作**：AI 做重复工作，你专注创造性决策
3. **持续优化**：记录有效提示，建立个人提示库

现在，去把那些让你头疼的任务交给 Claude Code，享受纯粹的编程乐趣吧！🚀