Open Code教程（三）| 实战案例集

OpenCode 实战案例集

一、前言

前两篇我们学习了 OpenCode 的安装配置和命令技巧。本文通过 15 个真实开发场景，展示如何用 OpenCode 解决实际问题。

二、实战案例

案例 1：理解陌生代码库

你刚接手一个项目，需要快速了解代码结构：

这个项目是做什么的？帮我梳理一下整体架构和核心模块

进阶用法：

@src/api/ 这个目录下的 API 是如何组织的？有哪些主要接口？

案例 2：解释复杂函数

遇到一个复杂的函数，看不懂逻辑：

@src/utils/parser.ts 中的 parseExpression 函数是做什么的？ 请逐行解释它的逻辑，特别是递归部分

案例 3：添加新功能

需要给用户模块添加邮箱验证功能（推荐先 Plan 后 Build）：

步骤 1：按Tab切换到 Plan 模式规划

我想给用户注册流程添加邮箱验证功能，要求： 1. 注册时发送验证邮件 2. 用户点击链接完成验证 3. 未验证用户限制某些功能 请帮我规划实现方案，包括需要修改哪些文件、新增哪些接口

步骤 2：确认方案后，按Tab切换到 Build 模式实现

按照刚才的方案，先实现第一步：注册时发送验证邮件

案例 4：调试错误

代码报错，需要定位和修复：

登录功能报错，错误信息如下： TypeError: Cannot read properties of undefined (reading 'token') at AuthService.login (auth.service.ts:45:23) 请帮我分析原因并修复

带文件引用的版本：

@src/services/auth.service.ts 第 45 行报错： Cannot read properties of undefined (reading 'token') 请帮我定位问题并修复

案例 5：代码重构

代码太乱，需要重构优化：

@src/utils/request.ts 这个文件的代码比较混乱，请帮我重构： 1. 使用 async/await 替代 Promise.then 链 2. 提取公共的错误处理逻辑 3. 添加请求/响应拦截器 4. 保持 API 兼容，不影响现有调用

案例 6：编写单元测试

需要为核心函数编写测试：

为 @src/utils/cart.ts 中的 calculateTotal 函数编写单元测试 测试场景： 1. 空购物车返回 0 2. 单个商品正确计算 3. 多个商品正确累加 4. 商品数量为 0 的情况 5. 有折扣时正确计算 使用 Jest 框架

案例 7：API 接口开发

需要新增一个 REST API 接口：

帮我创建一个商品搜索接口： 接口：GET /api/products/search 参数： - keyword: 搜索关键词（必填） - category: 分类 ID（可选） - minPrice: 最低价格（可选） - maxPrice: 最高价格（可选） - page: 页码，默认 1 - pageSize: 每页数量，默认 20 返回：分页的商品列表 请按照项目现有的代码风格实现

案例 8：数据库操作

需要编写数据库查询或迁移：

帮我写一个 SQL 查询： 查找过去 30 天内，订单金额超过 1000 元的用户， 按订单总金额降序排列，返回用户 ID、用户名、订单数、总金额

案例 9：性能优化

页面加载慢，需要优化：

@src/pages/ProductList.tsx 这个页面加载很慢，帮我分析可能的性能问题并优化 已知问题： - 商品列表有 1000+ 条数据 - 每次滚动都会重新渲染 - 图片加载慢

案例 10：代码审查

Review 同事的代码，找出问题：

帮我 Review 以下代码，找出潜在问题： @src/services/payment.service.ts 重点关注： 1. 安全问题 2. 错误处理 3. 边界情况 4. 代码规范

案例 11：文档生成

需要为代码生成文档：

为 @src/utils/api.ts 中的所有导出函数生成 JSDoc 注释

为这个项目生成 README.md，包括：项目介绍、技术栈、安装步骤、使用说明

案例 12：类型定义

需要为 JavaScript 代码添加 TypeScript 类型：

@src/utils/helpers.js 这个文件是 JavaScript 写的， 帮我转换为 TypeScript，添加完整的类型定义

根据 API 响应生成类型：

根据这个 API 响应示例，生成 TypeScript 接口定义： { "code": 0, "data": { "id": 1, "name": "商品名称", "price": 99.9, "stock": 100, "category": { "id": 1, "name": "分类名称" } } }

案例 13：Git 操作辅助

需要帮助处理 Git 相关问题：

!git status 帮我分析当前的 Git 状态，这些修改应该怎么组织 commit？

帮我写一个 commit message，描述刚才的修改

案例 14：配置文件处理

需要修改或生成配置文件：

帮我配置 ESLint，要求： - 使用 TypeScript - 集成 Prettier - 适合 React 项目 - 添加常用的代码规范规则

案例 15：学习新技术

想学习项目中使用的某个技术：

这个项目使用了 Zustand 做状态管理，我之前没用过 帮我解释 @src/stores/userStore.ts 中的代码，并教我 Zustand 的基本用法

三、实战技巧总结

1. 善用文件引用：@具体文件比 “那个文件” 更精确
2. 提供足够上下文：错误信息 + 相关代码 + 期望结果
3. 分步骤处理复杂任务：Plan 规划 → 确认方案 → Build 实现
4. 利用 Shell 命令获取信息：!git status/!npm test
5. 迭代优化：第一版不满意？继续对话优化，不用重新开始

四、下一篇预告

本文展示了 OpenCode 在各种开发场景中的应用。下一篇《OpenCode 高级配置与集成》将介绍本地模型配置、AGENTS.md 定制、IDE 集成和 GitHub 集成等高级功能。