跳到主要内容

键盘快捷键

Termia 的快捷键来自同一张表,菜单栏、命令面板与设置窗口共用它—— 不存在"菜单快捷键"和"应用快捷键"两份不同的清单。打开帮助 → 键盘快捷键…,或前往 设置 → 终端页并滚动到键盘区,就能看到你这台机器上当前生效的完整表。

预设​

在快捷键表中检查动作、快捷键作用域与绑定来源。
在快捷键表中检查动作、快捷键作用域与绑定来源。查看原图 ↗

预设是一张默认键的底表。Termia 内置两套:

  • macOS / 终端(推荐)——新安装的默认值。对齐 Ghostty 与 Apple 终端:⌘N 新建窗口、 ⌘T 主机库、⌘L 本地终端、⌘W 关闭面板、⌘⇧W 关闭窗口、⌘M 最小化、⌘0 重置字号、⌘9 最后一个标签页、⌘[ / ⌘] 切换标签页、⌥⌘[ / ⌥⌘] 切换面板。
  • Termius 运维——为从 Termius 迁移过来的用户准备:⌘L 本地终端、⌘T 新建连接、 ⌘W 关闭标签页、⌘K 命令面板、⌘J 跳转到标签页、⌘B 广播控制、⌘[ / ⌘] 切换标签页。

在键盘区顶部的键位预设下拉菜单里切换。换预设只换底表——你在 keybindings.json 里自定义过的键在任何一套预设下都照常生效,不受影响。

如果你的配置文件里存着一个已经不存在的旧预设值,Termia 会在下次启动时自动回退到推荐 预设,并静默改写这个设置项;你在 keybindings.json 里的覆盖不会被动。这个过程不会 弹提示——如果更新后某个快捷键看起来不对,去查一下键位表。

每个动作及其在各预设下的键​

括号里的动作 id 就是你在 keybindings.json 里写在条目左边的那个字符串(见下文)。 键一栏写"—"表示该预设没有给这个动作分配键——它仍然可以从菜单栏或命令面板触发。分组 方式与设置页键位表的分组完全一致。

应用​

动作macOS / 终端Termius 运维
新建窗口(window:new)⌘N⌘N
设置…(app:settings)⌘,⌘,
命令面板…(app:commandpalette)⇧⌘P⌘K(别名 ⇧⌘P)
插件…(app:plugins)——
资料快捷面板…(vault:quick)——
重新聚焦终端(app:refocus)⌘I⌘I

窗口​

动作macOS / 终端Termius 运维
关闭窗口(window:close)⇧⌘W⇧⌘W
最小化(window:minimize)⌘M⌘M
工作区 1 – 工作区 9(workspace:1 … workspace:9)⌃⌘1 … ⌃⌘9⌃⌘1 … ⌃⌘9

标签页​

动作macOS / 终端Termius 运维
新建本地终端(tab:new)⌘L⌘L
新建连接…(conn:new)—⌘T
切换连接…(conn:switch)——
关闭标签页(tab:close)⌥⌘W⌘W
上一个标签页(tab:prev)⌘[(别名 ⇧⌘[、⌃⇧⇥)⌘[(别名 ⇧⌘[)
下一个标签页(tab:next)⌘](别名 ⇧⌘]、⌃⇥)⌘](别名 ⇧⌘])
最后一个标签页(tab:last)⌘9—
主机库(tab:home)⌘T—
跳转到标签页…(tab:jump)—⌘J
标签页 1 – 标签页 8(tab:1 … tab:8)⌘1 … ⌘8⌘1 … ⌘8
标签页 9(tab:9)—(⌘9 是"最后一个标签页")⌘9

面板​

动作macOS / 终端Termius 运维
新建面板(pane:new)——
新建网页面板(pane:new:web)⇧⌘B⇧⌘B
新建 Git 面板…(pane:new:git)——
新建监控面板(pane:new:sysinfo)⇧⌘E⇧⌘E
新建文件面板(pane:new:preview)⇧⌘O⇧⌘O
向右分割(pane:splitright)⌘D⌘D
向下分割(pane:splitdown)⇧⌘D⇧⌘D
向左分割(pane:splitleft)仅能通过 ⌃⇧S 组合起手仅能通过 ⌃⇧S 组合起手
向上分割(pane:splitup)仅能通过 ⌃⇧S 组合起手仅能通过 ⌃⇧S 组合起手
关闭当前面板(pane:close)⌘W—
放大 / 还原当前面板(pane:magnify)⇧⌘↩⇧⌘↩
上一个面板(pane:prev)⌥⌘[—
下一个面板(pane:next)⌥⌘]—
焦点移到上方面板(pane:focusup)⌥⌘↑⌥⌘↑
焦点移到下方面板(pane:focusdown)⌥⌘↓⌥⌘↓
焦点移到左侧面板(pane:focusleft)⌥⌘←⌥⌘←
焦点移到右侧面板(pane:focusright)⌥⌘→⌥⌘→
面板向上扩展(pane:resizeup)⌃⌘↑⌃⌘↑
面板向下扩展(pane:resizedown)⌃⌘↓⌃⌘↓
面板向左扩展(pane:resizeleft)⌃⌘←⌃⌘←
面板向右扩展(pane:resizeright)⌃⌘→⌃⌘→
均分所有面板(pane:equalize)⌃⌘=⌃⌘=
焦点回到标签栏(pane:focuschrome)⌃F6⌃F6
多终端同时输入(pane:multiinput)⌃⇧I⌃⇧I
广播控制…(pane:broadcast)—⌘B
聚焦面板 1 – 聚焦面板 9(pane:1 … pane:9)⌃⇧ + 物理数字键 1–9⌃⇧ + 物理数字键 1–9

面板编号键(pane:1 … pane:9)按键盘上的物理位置匹配,而不是按你的键盘布局在 那个位置产生的字符——换成非英文布局也是同一组键。

终端​

动作macOS / 终端Termius 运维
查找…(app:find)⌘F⌘F
查找下一个(search:next)⌘G⌘G
查找上一个(search:prev)⇧⌘G⇧⌘G
清空回滚(term:clear)⌘K—

视图​

动作macOS / 终端Termius 运维
放大字号(view:zoomin)⌘=(别名 ⇧⌘=)⌘=(别名 ⇧⌘=)
缩小字号(view:zoomout)⌘−⌘−
恢复默认字号(view:zoomreset)⌘0⌘0

一次按键怎么被解析​

你按下一个键之后,Termia 依次检查三张表,命中哪一张就到此为止:

  1. 预设——上面这张表,对应设置里选中的预设(settings.json 里的 native:keymap)。
  2. keybindings.json——叠在预设之上的自定义覆盖。一个动作一旦被覆盖, 它的整条绑定(包括别名)都换成你写的那份。
  3. 终端引擎自带的内置键——只有预设和你的覆盖都没有认领这个键时才会轮到它。 Termia 的键位处理器比终端视图更早拿到每一次按键;命中一个已绑定动作就会 把事件吃掉,终端根本看不到这次按键。没有应用级绑定的键(包括你主动解绑过 的键)会落到终端引擎,再从那里像你直接敲进去一样送到 shell。

这就是"解绑一个快捷键"和"从来没绑过"的区别:主动解绑,才是把这个键还给终端引擎 或 shell 的方式。

keybindings.json 文件格式​

为选定操作录制快捷键,保存前检查保留键与冲突。
为选定操作录制快捷键,保存前检查保留键与冲突。查看原图 ↗

keybindings.json 和 settings.json 放在同一个配置目录里。只需要写你想改的 动作——没提到的动作照旧用预设的键。

{
  "tab:new": "Cmd:Shift:l",
  "pane:splitright": ["Cmd:d", "Cmd:Option:d"],
  "pane:close": null
}
  • 单个字符串("Cmd:Shift:l")把这个键设为该动作唯一的键。
  • 字符串数组可以设多个键:第一个是主键(会显示在菜单和 tooltip 里), 其余都是别名——能触发动作,但从不出现在菜单里。
  • null、"" 或 [] 彻底解绑该动作:没有任何键能触发它,这个键随之空出来, 可以被终端引擎或 shell 使用。

给一个动作写覆盖会连它的预设别名一起替换掉——如果你把 tab:new 改绑到别的键, 预设原本给它的 ⌘L 主键也会一并替换,因为这个动作现在的整条绑定就是你写的那份。

动作 id 不区分大小写,与上面各表括号里印出来的一致(例如 pane:splitright、 view:zoomin)。Termia 认不出的 id、或解析不了的键字符串,会被忽略——见下面的 "热加载"。

键描述语法​

一条键描述是冒号分隔的修饰键,后面跟一个键名:

  • 修饰键:Cmd(或 Meta)、Shift、Ctrl、Option(或 Alt)——任意组合、 任意顺序,例如 Cmd:Shift:d、Ctrl:Shift:ArrowUp。
  • 单个大写字母隐含 Shift:"D" 与 "Shift:d" 等价。
  • 具名键:ArrowLeft、ArrowRight、ArrowUp、ArrowDown、Escape、Enter、 Tab、Backspace、Space、Home、End、PageUp、PageDown,以及 F1–F12。
  • 其它写法按你的键盘为那个键发出的字面字符匹配,例如 "Cmd:,"。
  • 物理键码——c{Digit1} … c{Digit9}、c{Digit0},以及 c{Numpad1} … c{Numpad9}、c{Numpad0}——按键在键盘上的物理位置匹配,而不是它产生的字符, 所以换任何布局效果都一样。例如面板编号快捷键就是用 "Ctrl:Shift:c{Digit1}" 这样定义的。

热加载​

keybindings.json 保存后立即生效——不需要重启终端或整个应用。Termia 不单独监听 这个文件:本来就在盯着 settings.json 的配置目录监听器,只要目录里任何 *.json 发生变化就会触发一次,Termia 靠比较文件字节来只认真处理 keybindings.json 真的 被改过的那些事件。

  • 单条坏条目——认不出的动作 id、解析不了的键字符串、或者值既不是字符串也 不是数组——会被跳过并记录一条日志,文件里其余条目照常生效。键盘区会列出被 忽略的条目。
  • 整份文件坏掉——JSON 语法错误,或者顶层不是一个对象——会被整体拒绝: Termia 保留上一份成功加载的表,并弹出一条常驻通知("keybindings.json 无法 解析"),带一个显示文件的入口,这样你改到一半也不会丢键。等你保存一份能 重新解析的文件,这条通知会自动消失。
  • 切换预设、编辑 keybindings.json、恢复默认或导入文件,都会取消正在等待第二 段按键的快捷键组合(见下面的分割组合键)——它所依赖的表刚好换了。

冲突与保留键​

当同一个键被绑给两个作用域有交集的不同动作时,就构成一次冲突(查找条里 的"查找下一个"和终端里别的动作用同一个键不算冲突,因为它们永远不会争抢同一次 按键)。两套内置预设自身都没有冲突;只有你自己加了覆盖之后才可能出现。一旦出现, 上面各表中排在前面的那个动作生效,键盘区会把两行都标出来,悬停即可看到当前 生效的是哪一个。

保留键指那些本来就有别的含义的键——你仍然可以绑定它们,但 Termia 会提示, 因为这样做会盖住它们原来的用途:

  • shell / TUI 控制键:⌃C、⌃D、⌃Z、⌃R、⌃W、⌃A、⌃E、⌃U、 ⌃K、⌃L。
  • macOS 系统组合键:⌘Q、⌘H、⌥⌘H、⌘⇥、⌘␣、⇧⌘3、⇧⌘4、⇧⌘5。

这些只是提示,不是限制——Termia 不会阻止你使用它们,因为终端引擎往往仍然需要把 底层的控制字符送到 shell(比如 ⌃C 用来中断正在运行的命令),哪怕你同时把一个 应用动作也绑在了这个键上。

恢复默认、导入与导出​

键盘区顶部的配置文件菜单有四个动作:

  • 恢复默认——把当前的 keybindings.json 备份为 keybindings.json.bak (覆盖上一次的备份),然后删掉它。之后就是纯净的所选预设,没有任何覆盖。 如果你本来就没有自定义文件,这个操作什么也不做,并会这样提示你。

  • 导出…——把当前的完整设置写成一份 JSON 文件(默认文件名 termia-keymap.json),结构是:

    {
      "format": "termia-keymap/1",
      "preset": "macos-terminal",
      "overrides": { "...": "你的 keybindings.json 条目" },
      "effective": { "...": "每个动作最终生效的键,仅供查阅" }
    }
    

    effective 这部分只是给人看的——重新导入这份文件时读的是 overrides(以及 preset),从不读 effective。

  • 导入…——先整体校验整份文件。哪怕只有一条认不出或解析不了,整次导入都会 被拒绝,你现有的文件保持不动——导入不会替你应用"坏文件里能用的那一半"。 校验通过后,会先备份你现有的 keybindings.json,再写入新文件并立即生效。 如果导入的导出文档里带着一个不同的预设,预设也会随之切换。

  • 显示文件——在 Finder 里定位 keybindings.json(文件还不存在时定位到配置 目录)。

你也可以直接在键盘表里改单个动作:双击它的快捷键单元格(或选中该行按 Return) 进入录制态,录制中按 Backspace 清除绑定,按 Escape 取消且不做任何改动。右键一行 会给出更改快捷键…、清除绑定、恢复预设、复制动作 id(就是你会写进 keybindings.json 里的那个 id)。表格上方的搜索框可以按动作名、id 或按键文字 匹配,也可以点它旁边的键盘图标按钮,然后按下一个组合键,只列出绑到这个键的动作。

⌃⇧S 分割组合键​

要往一个没有单独快捷键的方向分割面板——或者干脆只有靠这个组合键才能到达的方向, 因为 pane:splitleft 和 pane:splitup 只作为这个组合键的第二段存在——用一个 两段式按键序列:

  1. 按下 ⌃⇧S。Termia 会吃掉这次按键,并在窗口底部显示一条提示("⌃⇧S 分割:按 ← → ↑ ↓ 选方向 · Esc 取消 …")。
  2. 按一个方向键:← 向左分割,→ 向右分割,↑ 向上分割,↓ 向下分割。 分割立即执行。

什么会取消它:

  • Escape 取消并被吞掉——不会传到 vim 或终端里的任何其它程序。
  • 其它任何键同样会取消这个组合,但会照常透传:如果你不小心按了 ⌃⇧S 之后接着打字,敲的字不会丢。
  • 2 秒无操作会静默取消,效果和按了一个无关的键一样。
  • 切换窗口、窗口失去焦点,或者键位表被重新加载(切预设、改 keybindings.json、恢复默认、导入),都会取消正在进行中的组合。

这个组合键的起手键、以及哪个方向键对应哪个分割方向,都是固定的,不能通过 keybindings.json 配置。pane:splitright 和 pane:splitdown 另外还有各自 的默认直接快捷键(⌘D、⇧⌘D),所以这两个方向两种方式都能触发。

设置窗口里的键盘区​

设置 → 终端页的末尾是键盘区,分两部分:

  • Option 键作为 Alt——控制 Option 键发给 shell 的内容。可选不作为 Alt (默认,保留 macOS 的国际字符输入,比如用 ⌥e 打重音字符)、仅左 Option、仅右 Option、两个 Option 都作为 Alt。作为 Alt 时, ⌥ + 字母会改发一个 Esc 前缀(Emacs 与基于 readline 的 shell 认的 Meta 键),走这个键的重音输入随之失效。
  • 键位表——预设下拉菜单、配置文件菜单,以及上面列出的每个动作的完整表格, 可搜索、可排序,列有动作、作用域、快捷键与来源(预设、自定义、 已取消,没有默认键的动作留空)。依赖尚未完成功能的行会显示为灰色,永远 不响应按键——本页表格里只列出了已经完全可用的动作。