OpenCode 中文社区

Appearance

2.1 界面与操作 ​

💡 一句话总结：掌握 @ 引用文件、! 执行命令、/ 斜杠命令，你就能驾驭 OpenCode。

学完你能做什么 ​

  • 看懂 TUI 界面的每个区域
  • 用 @ 引用项目中的文件
  • 用 ! 执行系统命令
  • 用 / 调用斜杠命令
  • 记住最常用的快捷键

核心思路 ​

TUI 界面导览 ​

启动 OpenCode 后，你会看到这样的界面：

┌─────────────────────────────────────────────────┐
│  OpenCode v1.0.0                    Build 模式  │  ← 状态栏
├─────────────────────────────────────────────────┤
│                                                 │
│  AI: 你好！有什么我可以帮你的？                   │  ← 对话区
│                                                 │
├─────────────────────────────────────────────────┤
│  > 在这里输入你的消息...                         │  ← 输入区
└─────────────────────────────────────────────────┘

区域作用：

  • 状态栏：显示版本、当前模式（Plan/Build）、Token 用量
  • 对话区：AI 回复和你的消息历史
  • 输入区：你输入消息的地方

核心操作三件套 ​

符号作用示例
@引用文件@src/main.ts 这个文件做了什么
!执行命令!ls -la 查看目录
/斜杠命令/help 查看帮助

跟我做 ​

第 1 步：启动 OpenCode 并进入项目 ​

bash
cd ~/your-project  # 换成你的项目路径
opencode

第 2 步：让 AI 介绍自己 ​

在输入区输入：

你好，请简单介绍一下你自己

按 Enter 发送。你应该看到 AI 回复一段自我介绍。

第 3 步：用 @ 引用文件 ​

输入：

@package.json 这个文件描述了什么项目

💡 自动补全：输入 @ 后按 Tab，会弹出文件选择器。

第 4 步：用 ! 执行命令 ​

输入：

!ls -la

你应该看到当前目录的文件列表显示在对话中。

第 5 步：用 / 调用斜杠命令 ​

输入：

/help

你应该看到所有可用斜杠命令的列表。

常用斜杠命令：

  • /help - 查看帮助
  • /new - 新建会话
  • /models - 切换模型
  • /theme - 切换主题
  • /exit - 退出

第 6 步：学会常用快捷键 ​

快捷键作用
Tab切换 Plan/Build 模式
Ctrl+C中断当前操作
Ctrl+L清屏
Ctrl+XLeader 键（前缀键）
Ctrl+X N新建会话
Esc取消/返回

什么是 Leader 键 ​

Leader 键是一种快捷键组合方式。先按 Ctrl+X，松开后再按另一个键。

例如：Ctrl+X 然后 N = 新建会话

检查点 ​

✅ 全部通过才能继续：

  • [ ] 用 @文件名 能引用到项目文件
  • [ ] 用 !命令 能执行系统命令
  • [ ] 用 /help 能看到帮助信息
  • [ ] Tab 键能切换 Plan/Build 模式

踩坑提醒 ​

现象原因解决
@ 后没有文件补全不在项目目录下cd 到项目目录重新启动
! 命令报权限错误OpenCode 拦截了危险命令确认命令安全后按 y 允许
快捷键不生效终端劫持了按键检查终端设置，或换一个终端

下一课预告 ​

下一课我们学习 2.1b 如何复制内容。你会学到：

  • 为什么 Ctrl+C 不能复制
  • Win/Mac 如何用鼠标复制
  • 怎样复制 AI 的长代码
微信群