OpenCode技巧 - 提升编码效率10倍

##必备键盘快捷键

掌握这些快捷键可以大幅提升你的工作效率。

###导航

| 快捷键 | 操作 | |--------|------| | Ctrl+C | 取消当前操作 | | Ctrl+L | 清屏 | | Ctrl+R | 搜索命令历史 | | Tab | 自动补全命令 | | ↑/↓ | 浏览历史记录 |

###编辑

| 快捷键 | 操作 | |--------|------| | Ctrl+A | 移动到行首 | | Ctrl+E | 移动到行尾 | | Ctrl+W | 向后删除单词 | | Ctrl+U | 删除整行 | | Ctrl+K | 删除到行尾 |

###会话控制

| 快捷键 | 操作 | |--------|------| | Ctrl+D | 退出OpenCode | | Ctrl+Z | 挂起到后台 | | Esc | 取消多行输入 |

##高效提示词技巧

###保持具体明确

不要这样写：

bash

修复bug

应该这样写：

bash

修复 src/utils/parser.ts 第45行的空指针异常，
该异常在解析空JSON数组时发生

###提供上下文

不要这样写：

bash

添加验证

应该这样写：

bash

在 components/SignupForm.tsx 的注册表单中添加邮箱验证，
使用 lib/validators.ts 中已有的验证工具

###使用分步指令

对于复杂任务，分解步骤：

bash

我需要为API添加缓存层：
1. 首先，分析 src/api/ 中的当前API结构
2. 为GET端点设计缓存策略
3. 使用Redis实现，TTL设为5分钟
4. 在POST/PUT/DELETE时添加缓存失效
5. 为缓存逻辑编写测试

##斜杠命令

快捷命令提升效率：

| 命令 | 描述 | |------|------| | /help | 显示所有可用命令 | | /clear | 清除对话历史 | | /model | 切换AI模型 | | /compact | 压缩对话 | | /cost | 显示token使用和费用 | | /diff | 显示待处理的文件更改 | | /undo | 撤销上次文件更改 |

###自定义斜杠命令

在 ~/.config/opencode/commands.yaml 中创建自定义命令：

bash

commands:
  /review:
    description: "代码审查当前更改"
    prompt: |
      审查当前git diff中的：
      - 代码质量问题
      - 潜在bug
      - 安全隐患
      - 性能问题
      为发现的每个问题提供具体建议。

  /commit:
    description: "生成提交信息"
    prompt: |
      分析暂存的更改并生成符合规范的提交信息。
      格式：<类型>(<范围>): <描述>

  /doc:
    description: "生成文档"
    prompt: |
      为选中的代码生成完整的JSDoc/TSDoc文档。
      包含参数描述、返回类型和示例。

##上下文管理

###使用@引用

引用特定文件或符号：

bash

@src/components/Button.tsx 添加悬停动画
@useAuth hook 添加token刷新逻辑
@package.json 更新React到最新版本

###目录上下文

处理整个目录：

bash

@src/api/ 重构所有端点使用async/await
@tests/ 更新所有测试使用新的mock系统

###Git上下文

引用git状态：

bash

@git:staged 在提交前审查这些更改
@git:branch:feature-auth 显示与main的差异

##工作流优化

###基于模板开发

为常见任务创建可重用的提示词：

bash

你：/template component

OpenCode：正在创建新的React组件...
- 名称：[UserProfile]
- Props：[user: User, onEdit: () => void]
- 样式：[Tailwind CSS]
- 测试：[是]

###迭代式开发

逐步构建复杂功能：

bash

步骤1："创建产品的基本CRUD API"
步骤2："为列表端点添加分页"
步骤3："添加按类别和价格范围筛选"
步骤4："为频繁访问的产品添加缓存"
步骤5："添加完善的错误处理"

###并行任务

同时处理多个任务：

bash

在你实现前端表单的同时，也：
1. 创建API端点
2. 设置表单验证schema
3. 编写集成测试

##配置技巧

###针对技术栈优化

bash

# ~/.config/opencode/config.yaml
context:
  # 自动包含相关文件
  auto_include:
    - "package.json"
    - "tsconfig.json"
    - ".env.example"

  # 排除干扰
  exclude_patterns:
    - "node_modules/**"
    - "dist/**"
    - "*.log"

# 技术栈特定设置
presets:
  react:
    include: ["src/components/**", "src/hooks/**"]
  api:
    include: ["src/routes/**", "src/middleware/**"]

###自定义模型预设

bash

model_presets:
  quick:
    model: claude-3-5-haiku
    max_tokens: 1000

  thorough:
    model: claude-opus-4-20250514
    max_tokens: 8000
    temperature: 0.1

  creative:
    model: gpt-4o
    temperature: 0.8

##性能优化

###1. 选择合适的模型

快速任务：使用Haiku或GPT-4o-mini
复杂分析：使用Opus或GPT-4o
大型代码库：使用Gemini的200万上下文

###2. 最小化上下文

bash

# 只包含必要文件
context:
  max_files: 20
  max_tokens: 50000

###3. 启用缓存

bash

cache:
  enabled: true
  ttl: 3600  # 1小时
  max_size: 100MB

###4. 使用压缩模式

长会话时压缩上下文：

bash

/compact

##调试技巧

###详细模式

查看OpenCode的操作：

bash

opencode --verbose
# 或
export OPENCODE_DEBUG=1

###查看Token使用

实时监控费用：

bash

/cost

###检查上下文

查看包含了哪些文件：

bash

/context show

##最佳实践

###1. 先理解再行动

在修改前：

bash

分析这个代码库中的认证流程，解释用户会话是如何管理的。

###2. 接受前先审查

始终审查建议的更改：

bash

/diff

###3. 频繁提交

使用原子提交：

bash

/commit
git push

###4. 边开发边写文档

与代码一起生成文档：

bash

实现这个函数后，添加JSDoc文档。

###5. 测试驱动方法

先写测试：

bash

先为用户注册编写失败的测试，然后实现功能使测试通过。

##常用模式

###Bug修复模式

bash

1. "显示错误和第X行附近的相关代码"
2. "什么导致了这个问题？"
3. "修复bug并添加测试防止回归"
4. "/diff" 审查
5. "/commit" 带描述性信息

###功能开发模式

bash

1. "分析类似功能是如何实现的"
2. "规划[功能]的实现"
3. "逐步实现，从[组件]开始"
4. "为新功能添加测试"
5. "更新文档"

###代码审查模式

bash

1. "@git:staged 审查这些更改"
2. "关注[安全性/性能/可读性]"
3. "建议改进"
4. "应用批准的建议"