OpenCode 喂饭教程(中):Plan/Build 双模式与命令速查

OpenCode 喂饭教程(中):Plan/Build 双模式 + 5 个实战 + 命令速查

上篇我们把 OpenCode 装好了、DeepSeek 也接通了。但这只是把车开回家——真正上路还得会挂挡。OpenCode 的"挡位"就是 Plan 和 Build 两个模式,搞懂这俩,你才算真正会用这个工具。
这篇把双模式、五个实战、命令表、高级玩法一次性讲透。看完你就能拿它干 80% 的日常开发活。

OpenCode Plan 规划与 Build 构建双模式概念图
OpenCode Plan 规划与 Build 构建双模式概念图

核心模式:Plan 当架构师,Build 当工程师

OpenCode 和传统 IDE 最大的不同,就是引入了 Plan(规划)和 Build(构建)两种工作模式。这是它和 Cursor 那类"边看边改"工具的本质区别。

Plan 模式——按 Tab 切进来,OpenCode 变身"架构师"。它不会直接改代码,而是分析你的需求、阅读现有代码,给出一份详细的实施计划。适用场景:跨文件、逻辑复杂的任务,比如"给应用加用户登录""重构数据库模块"。你可以和它反复讨论计划直到满意。一个小技巧——Plan 模式下可以拖设计图或截图进去,让 AI 基于视觉稿出方案。

Build 模式——计划确认无误,再按一次 Tab(或在对话框确认),就进 Build。这时 OpenCode 变身"资深工程师",开始执行计划,直接在你的文件里写、改、删代码。它能自动创建新文件、跑终端命令(比如 npm install,需你授权)、看终端报错自动修复编译错误。改错了,/undo 一键回滚。

核心精髓一句话:先让 AI 出方案,再让 AI 写代码。这么干能避免直接编码导致的逻辑偏差,代码一次性通过率能提升 40% 以上。

实战 1:复杂功能先 Plan 再 Build

适合需要跨文件、多步骤的复杂功能开发,比如新增业务模块、开发新页面。

示例需求:实现用户删除笔记后标记为软删除,新增回收站页面支持恢复/永久删除。

第一步:切到 Plan 模式——按 Tab,确认右下角显示 Plan。

第二步:描述需求——终端里输入详细需求(把 AI 当初级开发者,越细越好):

当用户删除笔记时,在数据库中将该笔记标记为 deleted 状态(软删除,不真正删除);新增一个回收站页面,展示所有标记为 deleted 的笔记;在回收站页面,用户可以点击恢复按钮将笔记恢复为正常状态,也可以点击永久删除按钮彻底删除笔记。

第三步:迭代计划——OpenCode 会生成实施计划(改哪些文件、新增哪些接口、页面布局怎么设计)。不符合预期就接着在终端补充,比如:

回收站页面的设计参考项目中已有的笔记列表页面,使用相同的 UI 组件。

小技巧:可直接把设计图拖到终端,OpenCode 会自动识别图片内容当设计参考。

第四步:切到 Build 模式——确认计划无误,按 Tab 切换。

第五步:执行编码——终端输入"按照计划执行,完成所有修改"。OpenCode 会自动改数据库模型、加接口、开发页面,所有修改实时显示在终端,随时可看。

实战 2:简单修改直接 Build 跳过 Plan

适合单行代码修改、简单功能添加、代码重构这类轻量操作,比如给接口加鉴权、改按钮样式。

示例需求:给 /settings 路由添加鉴权,参考 /notes 路由的鉴权逻辑。

直接在 Build 模式下输入指令(要给够细节,指定参考文件):

给 @packages/functions/src/settings.ts 中的 /settings 路由添加身份验证,参考 @packages/functions/src/notes.ts 中 /notes 路由的鉴权逻辑,实现完全相同的功能。

小技巧:用 @ 符号可以模糊搜索项目文件,直接引用文件路径,不用手敲完整路径,效率高一大截。

Slash 命令面板与高频命令示意
Slash 命令面板与高频命令示意

实战 3:让 AI 给你讲祖传代码

接手新项目、看老代码,是程序员最头疼的活之一。OpenCode 能直接给你讲。

示例:解释 @packages/functions/src/api/index.ts 中的认证逻辑,说明每一步的作用。

适合快速接手新项目、理解同事代码,省掉逐行读的时间。这点对新人入职、跨组接手项目特别有用。

实战 4:撤销重做,改错了一键回滚

AI 生成的代码不符合预期,别手动改,直接用命令回滚:

  • 撤销修改:输入 /undo,撤销上一步操作,多次输入可连续撤销多次
  • 重做修改:输入 /redo,恢复最近一次撤销的修改

这是 AI 编程里最常用的一条保命命令,养成随手可撤的习惯,敢放手让 AI 干活。

实战 5:会话分享,团队同步开发思路

要和同事沟通开发方案,不用截图不用录屏——OpenCode 能把对话生成链接分享。

终端输入 /share,链接自动复制到剪贴板,同事打开就能看完整的需求分析、计划设计、代码修改过程。省去反复沟通的来回,对远程团队特别友好。

高频 Slash 命令速查表

OpenCode 的 Slash 斜杠命令是核心操作方式,所有功能都能命令触发,不用鼠标。开发里最常用的高频命令整理如下,建议收藏:

命令 核心功能 适用场景
/connect 配置 LLM 模型 API 密钥 首次使用/切换模型
/init 初始化项目,生成 AGENTS.md 新项目接入
/undo 撤销上一步修改 代码不符合预期
/redo 重做最近一次撤销 误操作撤销
/share 生成对话链接分享 团队协作
/add 添加指定文件到上下文 让 AI 聚焦特定文件
/compact 压缩上下文历史,释放 Token 对话过长
/review 代码审查,查 Bug/性能 提交前自动查错
/web 联网搜索最新资料/API 文档 查外部信息

完整命令列表在终端输入 / 就能触发,含 /help、/models、/prompt、/history、/clear、/export、/import、/settings、/theme、/language、/shortcut、/feedback、/update、/about、/quit 等十几条,每条都配了 Ctrl+x 系列快捷键。

高级玩法:自定义模型参数与 Agent

OpenCode 支持高度定制,能让工具完全适配你的开发习惯。分享两个最实用的。

1. 自定义模型参数,平衡效果与速度

配置面板里能调模型核心参数:

  • 温度参数(Temperature):0–1 区间,值越小代码越严谨(推荐 0.2–0.4,生产环境),值越大创造性越强(适合原型开发)
  • 最大生成长度(Max Tokens):限制单次生成代码长度,前端组件开发建议设 2048,避免冗余代码
  • 上下文扫描范围:可选当前文件/当前文件夹/整个项目,大型项目建议选"当前文件夹",减少性能消耗
自定义 Agent 与模型参数配置概念图
自定义 Agent 与模型参数配置概念图

2. 自定义 Agent,实现专属功能

能创建自定义 Agent(比如代码审查专家、安全检测专家),让 OpenCode 扮演特定角色。三步:

  1. 项目根目录建文件夹 .opencode/prompts/
  2. 创建自定义 Agent 文件(如 security.md),写系统提示词:

你是一名资深网络安全专家,专门检查代码中的 SQL 注入、XSS 漏洞、权限绕过等安全问题,发现问题后给出详细的修复方案,不直接修改代码。

  1. 终端输入 /run security,调用该 Agent 对项目做安全检测

这套玩法等于给 OpenCode 装专属技能,团队沉淀的经验能直接复用。

VSCode 集成:终端 + 编辑器无缝操作

习惯用 VSCode 的开发者,可以把 OpenCode 集成进 IDE,体验更好:

  1. VSCode 按 Ctrl+Shift+X(Win/Linux)或 Cmd+Shift+X(Mac)打开扩展市场
  1. 搜 OpenCode,装官方认证插件,重启 VSCode
  1. 打开底部终端,按正常步骤启动使用即可
  1. 小技巧:在 keybindings.json 绑定快捷键(如 Ctrl+'),快速唤起 OpenCode
VSCode 集成文件树拖拽到终端自动 _add
VSCode 集成文件树拖拽到终端自动 _add

 

最大优势——能把 VSCode 左侧文件树的文件直接拖到终端,OpenCode 自动执行 /add 加进上下文,操作效率拉满。

快捷键速查

基础操作

快捷键 功能
Enter 提交消息
Shift+Enter 或 Ctrl+j 输入换行
Ctrl+v 粘贴
Ctrl+c 清空输入/退出
Tab 切换 Agent(Plan/Build)
Shift+Tab 反向切换 Agent
Escape 中断当前会话

消息浏览

快捷键 功能
PgUp / PgDown 上下翻页
Ctrl+Alt+u / Ctrl+Alt+d 上下翻半页
Ctrl+g 或 Home 跳到第一条消息
Ctrl+Alt+g 或 End 跳到最后一条消息
Ctrl+x y 复制消息

这套 Plan+Build 双模式 + Slash 命令体系,是 OpenCode 区别于其他 AI 编程工具的核心。用好它,你会发现"指挥 AI 干活"比"自己敲"快太多。

下篇会讲 OpenCode 的 skill 安装和使用——把它优化到和官方那些 TUI 工具一样好用。这是系列的最后一篇,关注后续更新。

本文网址:https://blog.520zyw.com/43.html
转载请声明来自:伍零博客 - OpenCode 喂饭教程(中):Plan/Build 双模式与命令速查


使用声明:

1、本站所有素材,仅限学习交流,请勿用于商业用途。

2、本站资源大多无解压密码,如遇需要解压密码,无特殊说明,均为:伍零博客

3、下载积分可通过日常 签到、绑定邮箱 等途径免费获得!

4、本站提供的源码、模板、软件工具等其他资源,均不包含技术服务,请大家谅解!由于资源大多存储在云盘,如出现链接失效请评论反馈。

5、如果素材损害你的权益,请 联系我们 给予处理。