07-代码分析与重构掌握 OpenCode 的代码分析和重构功能实现批量编辑、智能分析和代码库问答。一、代码分析概述1.1 分析能力OpenCode 可以分析整个代码库提供结构分析模块依赖、调用关系质量分析代码规范、复杂度安全分析漏洞扫描、风险识别性能分析瓶颈识别、优化建议1.2 分析流程代码库 │ ├─► 代码读取 ──► 解析理解 │ │ │ ▼ │ 语义分析 │ │ │ ┌─────────┼─────────┐ │ ▼ ▼ ▼ │ 结构分析 质量分析 安全分析 │ │ │ │ │ └─────────┴─────────┘ │ │ │ ▼ │ 生成报告 │ │ │ ▼ │ 重构建议 ──► 执行重构二、批量编辑2.1 批量修改文件# 批量替换将所有文件中的user_name替换为username# 带条件替换在 app/models/ 下的所有文件中将id字段改为 UUID 类型# 批量添加在所有路由文件中添加错误处理装饰器2.2 批量生成# 批量创建为 app/models/ 下的每个模型创建对应的 schema# 批量更新更新所有测试文件以使用新的 fixture# 批量删除删除所有未使用的import语句2.3 批量重命名# 变量重命名将 User 类重命名为 UserModel并更新所有引用# 函数重命名重命名所有以 get_ 开头的函数为 fetch_# 文件重命名将所有 snake_case 的文件名改为 kebab-case三、智能代码分析3.1 项目结构分析# 分析项目结构分析项目架构 输出: 项目架构分析 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 主要模块: - app/(应用代码)- models/(数据模型)- routers/(API 路由)- services/(业务逻辑)- tests/(测试代码)- docs/(文档)依赖关系: - routers -services -models - services -external APIs 复杂度: - 高: services/order_service.py - 中: routers/users.py - 低: models/base.py ━━━━━━━━━━━━━━━━━━━━━━━━━━━━3.2 代码质量分析# 质量检查分析代码质量 输出: 代码质量报告 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ PEP8 检查: ✓ 通过率:95% ⚠ 警告:15个 ✗ 错误:0个 复杂度: - 平均圈复杂度:4.2- 最高: process_order()-12重复代码: - 发现3处重复 - 建议提取公共函数 类型注解: - 覆盖率:78% - 缺失: app/utils/helpers.py ━━━━━━━━━━━━━━━━━━━━━━━━━━━━3.3 安全分析# 安全扫描扫描安全漏洞 输出: 安全扫描报告 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 高优先级: ✗ app/routers/auth.py:45 SQL 注入风险: f-string 查询 建议: 使用参数化查询 ✗ app/utils/crypto.py:12 弱密码哈希: MD5 建议: 使用 bcrypt 中优先级: ⚠ app/main.py:30 硬编码密钥 建议: 使用环境变量 低优先级: ℹ 缺少输入验证:3处 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━四、代码库问答4.1 项目级问答# 查询代码库这个项目使用了哪些设计模式哪些函数调用了数据库找出所有使用 asyncio 的地方4.2 智能查询# 语义查询哪些代码处理用户认证# 依赖查询OrderService 依赖哪些其他服务# 影响分析修改 User 模型会影响哪些文件4.3 代码解释# 解释复杂代码解释 services/order_service.py 中的 process_order 函数# 解释架构解释这个项目的整体架构设计# 解释依赖为什么我们需要这个依赖五、重构模式5.1 提取函数# 提取重复代码将 app/routers/users.py 和 app/routers/posts.py 中重复的验证逻辑提取为公共函数# 提取类将相关的函数提取为 UserService 类5.2 重命名重构# 变量重命名将所有 user_name 重命名为 username全局# 类重命名将 User 重命名为 UserModel并更新所有引用5.3 移动重构# 移动函数将 utils/validation.py 中的 validate_email 移动到 utils/email.py# 移动类将 models.py 中的 Order 类移动到 models/order.py5.4 接口重构# 提取接口为 UserService 提取接口 IUserService# 修改接口在 UserService 中添加新的方法参数六、大规模重构6.1 框架迁移# SQLAlchemy 1.x 到 2.0将项目从 SQLAlchemy1.4迁移到2.0- 更新查询语法 - 修改会话管理 - 更新关系定义# Pydantic v1 到 v2迁移到 Pydantic v2 - 更新验证器语法 - 修改配置类 - 更新类型定义6.2 架构重构# 分层重构重构为 Clean Architecture - 分离 Domain、Use Case、Interface 层 - 创建 Repository 模式 - 实现依赖注入# 微服务拆分分析单体应用给出微服务拆分建议6.3 技术栈迁移# 数据库迁移从 MySQL 迁移到 PostgreSQL - 修改连接配置 - 更新 SQL 方言 - 迁移数据# 框架迁移从 Flask 迁移到 FastAPI - 转换路由 - 更新序列化 - 修改异步代码七、重构实战7.1 重构流程# 1. 分析现状分析当前代码库识别需要重构的部分# 2. 制定计划生成重构计划识别风险和依赖# 3. 执行重构执行第一步重构运行测试验证重复直到完成# 4. 验证结果运行所有测试检查代码质量验证功能完整7.2 重构示例# 重构前读取 app/services/order.py# 分析问题这个文件有哪些问题 输出: - 函数太长(process_order:120行)- 缺乏错误处理 - 重复代码 - 没有类型注解# 执行重构重构 OrderService:1. 提取子函数2. 添加错误处理3. 添加类型注解4. 优化性能# 验证运行相关测试检查重构后的代码质量八、最佳实践8.1 重构原则小步快跑每次只做一个小重构测试先行确保有测试覆盖再重构版本控制每次重构后提交团队协作大重构前与团队沟通8.2 安全重构# 1. 创建分支gitcheckout-brefactor/order-service# 2. 运行测试确保通过运行所有测试# 3. 执行重构重构 app/services/order.py# 4. 再次运行测试运行所有测试# 5. 代码审查/skill use code-reviewforapp/services/order.py# 6. 提交gitcommit-mrefactor: 重构 OrderService8.3 重构检查清单/skill use refactor-checklist 检查项: □ 测试通过 □ 代码规范检查通过 □ 类型检查通过 □ 无安全漏洞 □ 性能未下降 □ 文档已更新九、故障排除9.1 重构失败处理# 使用 Git 撤销重构推荐# 查看修改的文件gitstatus# 撤销所有修改gitcheckout --.# 或撤销特定文件gitcheckout -- app/models/user.py# 查看重构历史通过 Git 日志gitlog--oneline-10# 回滚到指定提交gitreset--hardHEAD~1# 回滚到上一个提交# 或gitreset--hardcommit-hash# 如果已提交但想撤销gitrevert HEAD# 创建新的撤销提交预防性建议重构前先提交git add . git commit -m 重构前保存小步重构频繁提交使用分支git checkout -b refactor-branch9.2 测试失败处理# 分析失败原因分析测试失败# 修复问题修复失败的测试# 重新运行运行测试十、下一步掌握代码分析与重构后建议学习08-OpenCode独有技巧.md - 进阶使用技巧09-实战PythonWebAPI开发.md - 完整项目实战11-项目规划测试代码审查实战.md - 全流程实战文档版本: 1.0 | 建议学习时长: 45分钟