代码修改
Claude Code 提供了强大的代码修改能力，可以帮助你快速、准确地修改代码。理解如何有效地引导 Claude 进行代码修改，是提高开发效率的关键。
代码修改的基本原则
明确性优于模糊性
清晰地表达你的意图：
❌ 不好的方式：
改进这个函数✅ 好的方式：
将这个函数改为异步函数，添加错误处理，并使用 try-catch 包裹数据库调用提供足够的上下文
让 Claude 理解修改的原因和影响：
这个组件目前在移动端显示有问题。需要添加响应式样式，
在小屏幕上改为垂直布局。参考 Header 组件的实现方式。一次一个焦点
避免在单个请求中混合多个不相关的修改：
❌ 不好的方式：
重构这个文件，添加类型定义，修复 bug，优化性能，更新文档✅ 好的方式：
首先添加 TypeScript 类型定义然后在下一步：
现在修复第 45 行的空指针 bug小型修改
单行或几行的更改
对于简单的修改，直接说明即可：
将第 23 行的超时时间从 3000 改为 5000在 handleSubmit 函数开头添加表单验证添加导入语句
添加 lodash 的 debounce 函数导入修改配置值
在 next.config.js 中启用 SWC minify中型修改
函数重构
提供清晰的重构目标：
重构 processUserData 函数：
1. 提取验证逻辑到单独的函数
2. 使用 async/await 替代 Promise 链
3. 添加详细的错误消息添加新功能
描述功能需求和实现方式：
在 UserProfile 组件中添加头像上传功能：
- 使用 react-dropzone 处理文件上传
- 限制文件大小为 5MB
- 支持 jpg、png 格式
- 上传前显示预览错误处理改进
改进 API 调用的错误处理：
- 区分网络错误和业务错误
- 添加重试逻辑（最多 3 次）
- 显示用户友好的错误消息大型修改
组件重构
对于大型重构，分步进行：
第一步：将 Dashboard 组件拆分为更小的子组件
先列出建议的组件结构审查结构后：
好的，按照这个结构开始重构，先创建 DashboardHeader 组件架构变更
将状态管理从 Redux 迁移到 Zustand：
1. 先创建 Zustand store 定义
2. 我会审查后再继续迁移组件API 重构
重构 REST API 为 GraphQL：
1. 先设计 GraphQL schema
2. 然后实现 resolvers
3. 最后更新客户端查询代码修改模式
添加模式
在 Button 组件中添加 loading 状态：
- 添加 isLoading prop
- loading 时显示 spinner
- loading 时禁用按钮删除模式
移除所有与旧认证系统相关的代码：
- 删除 src/auth/legacy/ 目录
- 移除 AuthContext 中的旧方法
- 清理相关的类型定义替换模式
将所有 moment.js 使用替换为 date-fns：
1. 先列出所有使用 moment 的地方
2. 逐个替换为等效的 date-fns 函数提取模式
从 UserDashboard 中提取可复用的逻辑：
- 提取数据获取逻辑到自定义 hook
- 提取格式化函数到 utils
- 提取常量到单独的文件处理依赖关系
识别影响范围
如果我们修改 User 接口，会影响哪些文件？级联更新
更新 User 接口添加 email 字段，然后更新所有受影响的文件向后兼容
添加新的 API 端点，但保持旧端点的兼容性，添加弃用警告代码风格和规范
遵循项目规范
按照项目的 ESLint 规则重构这个文件统一代码风格
将这个文件的代码风格统一为：
- 使用单引号
- 2 空格缩进
- 尾随逗号命名规范
将所有变量名改为驼峰命名法，函数名使用动词开头测试驱动的修改
先写测试
为 calculateDiscount 函数编写测试用例，
然后根据测试修改实现修改后验证
修改完成后，运行测试并修复任何失败的用例添加边界测试
为这个函数添加边界情况的测试：
- 空输入
- 极大值
- 负数
- 特殊字符性能优化修改
识别瓶颈
分析这个组件的性能问题，建议优化方案实施优化
优化 ProductList 组件：
- 使用 React.memo 避免不必要的重渲染
- 实现虚拟滚动
- 懒加载图片验证改进
添加性能监控代码，测量优化前后的差异安全性修改
修复安全漏洞
修复 XSS 漏洞：
- 对用户输入进行转义
- 使用 DOMPurify 清理 HTML
- 添加 CSP 头加强验证
加强输入验证：
- 添加服务端验证
- 使用 Zod 进行类型安全的验证
- 添加速率限制渐进式修改策略
小步快跑
重构这个 500 行的文件，每次修改一个函数，
修改后我会测试再继续功能开关
添加新功能，但使用 feature flag 控制，
默认关闭直到测试完成并行版本
创建新版本的 API 端点（v2），保持 v1 不变代码审查和迭代
请求审查
这是我的修改方案，请审查并提出改进建议迭代改进
根据你的建议，我想调整错误处理部分，
使用更细粒度的错误类型最终检查
修改完成，请检查：
1. 是否有遗漏的边界情况
2. 错误处理是否完整
3. 代码是否符合最佳实践文档同步
更新注释
修改函数签名后，同步更新 JSDoc 注释更新 README
添加新功能后，更新 README 的功能列表和使用示例更新类型定义
修改 API 响应格式后，更新 TypeScript 类型定义常见陷阱和解决方案
陷阱 1：修改范围过大
问题：一次性修改太多代码，难以调试
解决：分解为小步骤，每步验证
陷阱 2：忽略副作用
问题：修改一处代码，破坏了其他功能
解决：先分析依赖关系，制定完整的修改计划
陷阱 3：不一致的风格
问题：新代码与现有代码风格不一致
解决：明确指定要遵循的代码规范
陷阱 4：缺少测试
问题：修改后没有验证功能正确性
解决：修改前后都运行测试，必要时添加新测试
最佳实践清单
- [ ] 清晰描述修改意图和原因
- [ ] 提供足够的上下文信息
- [ ] 一次专注一个主要修改
- [ ] 考虑修改的影响范围
- [ ] 遵循项目的代码规范
- [ ] 保持向后兼容性（如适用）
- [ ] 更新相关的测试
- [ ] 同步更新文档和注释
- [ ] 验证修改的正确性
- [ ] 考虑性能和安全影响
通过遵循这些原则和模式，你可以更有效地使用 Claude Code 进行代码修改，提高代码质量和开发效率。