跳到主要内容
版本:0.9.x

键位绑定参考

本页列出了 Gitti 中所有可用的键位绑定,按上下文和场景进行组织。

图例​

  • * = 全局键位绑定(在没有弹出窗口时,适用于所有上下文)
  • * [!!] = 全局键位绑定,即使在弹出窗口打开时也有效

全局键位绑定​

键标记操作备注
ctrl+c* [!!]退出 Gitti强制退出,即使在弹出窗口中也有效
-*减小面板宽度缩小左侧面板
+*增加面板宽度扩大左侧面板
ctrl+s* [!!]暂存所有文件暂存所有修改的文件
ctrl+u* [!!]取消暂存所有文件取消暂存所有已暂存的文件
ctrl+g* [!!]打开作者的 GitHub在浏览器中打开作者的 GitHub
ctrl+l* [!!]打开作者的 LinkedIn在浏览器中打开作者的 LinkedIn
q 或 Q*退出 Gitti仅在没有弹出窗口时有效
?*打开全局键位绑定帮助在弹出窗口中显示所有键位绑定
C*继续操作 (Continue)通用继续操作 (rebase, merge, cherry-pick)
ctrl+a*中止操作 (Abort)通用中止操作 (rebase, merge, cherry-pick)
ctrl+f*获取全部手动获取全部
b*Git Blame打开任意追踪文件的 Blame 弹窗
O*在编辑器中打开仓库使用配置的编辑器打开当前仓库

组件导航​

键操作备注
1聚焦本地分支面板将焦点切换到分支列表
2聚焦修改的文件面板将焦点切换到文件列表
3聚焦提交日志 / RefLog 面板将焦点切换到提交日志 / RefLog
4聚焦 Stash 面板将焦点切换到 Stash 列表
/聚焦日志组件面板将焦点切换到应用日志
tab向前循环浏览组件移动到下一个面板
shift+tab向后循环浏览组件移动到上一个面板

列表导航​

键上下文操作
↑ 或 k任何列表面板向上移动 / 选择上一项
↓ 或 j任何列表面板向下移动 / 选择下一项
↑ 或 k弹出窗口选择列表导航到上一个选项
↓ 或 j弹出窗口选择列表导航到下一个选项

列表筛选​

按 F 筛选当前聚焦的列表面板。每个列表保留各自的筛选内容。

键操作备注
F开始筛选本地分支 / 标签 / 远程 / Worktree、修改的文件、提交日志 / RefLog、Stash
任意字符追加到筛选内容每次按键都会重新筛选列表
backspace删除最后一个字符每次按键都会重新筛选列表
enter应用并退出保留筛选内容,其他按键恢复正常操作
esc清除并退出清除筛选内容并恢复完整列表
  • 筛选为对列表条目文本的不区分大小写的子串匹配。
  • 当前筛选内容显示在面板的条目计数旁,例如 3/10 /feat。
  • 输入筛选内容时,其他键位绑定不会生效。请先按 enter 或 esc。
  • 按 enter 后筛选内容仍然生效。若要清除,请再次按 F,然后按 esc。
  • 弹出窗口打开时或处于行编辑模式时,F 无效。

鼠标支持​

操作结果
左键点击左侧面板聚焦该面板并选中点击的列表项
左键点击详细面板聚焦详细面板;按 esc 返回列表面板
左键点击日志面板聚焦日志面板
滚轮上 / 下滚动聚焦的详细面板,或已打开弹出窗口的内容
滚轮左 / 右横向滚动相同内容
  • 弹出窗口打开时、处于行编辑模式时,以及输入筛选内容时,点击会被忽略。
  • 弹出窗口打开时滚轮仍然有效。

详细面板滚动​

键操作上下文
↑ 或 k向上滚动在详细组件内
↓ 或 j向下滚动在详细组件内
← 或 h向左滚动在详细组件内
→ 或 l向右滚动在详细组件内

本地分支面板​

键操作场合
< / >切换组件面板在本地分支、标签、远程和 Worktree 之间切换
n创建新分支打开分支创建流程
enter切换到选定分支如需要则打开切换分支弹出窗口
d删除选定分支删除分支(需要确认)
r变基到另一个分支仅在选定分支为已检出分支时有效
m合并分支到当前分支打开多分支合并选择器
F筛选分支列表输入以筛选,enter 应用,esc 清除

修改文件面板​

键操作何时
space切换 暂存/取消暂存在暂存和未暂存之间切换文件
e编辑文件在外部编辑器/终端中打开文件
enter查看文件差异在详细面板中显示差异
r解决冲突打开冲突解决选项(仅在冲突文件时显示)
d丢弃更改打开丢弃确认流程
s暂存选中的文件打开暂存消息输入弹窗
S暂存所有文件打开暂存消息输入弹窗
c提交打开提交弹窗
A修正提交打开修正提交弹窗
F筛选文件列表输入以筛选,enter 应用,esc 清除

提交日志面板​

键操作备注
< / >切换到 RefLog切换到 RefLog 面板
r重置选定的提交打开重置选项(Soft/Mixed/Hard)
R重置最新提交打开 HEAD 的重置选项(Soft/Mixed/Hard)
ctrl+r还原提交打开提交还原选项
t创建标签打开创建标签菜单
ctrl+pCherry Pick 模式进入 Cherry Pick 选择模式
i交互式变基打开交互式变基操作选择器
enter查看提交详情在详细面板中显示提交差异
F筛选提交日志输入以筛选,enter 应用,esc 清除

RefLog 面板​

键操作备注
< / >切换到提交日志切换回提交日志面板
↑ or k移动到上一条目
↓ or j移动到下一条目
enter查看条目详情在详细面板中显示条目信息
n从提交哈希创建新分支打开分支名称输入弹出窗口
r重置到选定提交打开重置选项(Soft/Mixed/Hard)
ctrl+p在当前分支上 Cherry Pick打开 Cherry Pick 确认弹出窗口
F筛选 RefLog 列表输入以筛选,enter 应用,esc 清除

Stash 面板​

键操作场合
space应用 Stash应用 Stash 但保留在列表中
backspace弹出 Stash应用 Stash 并从列表中删除
d删除 Stash永久删除 Stash
F筛选 Stash 列表输入以筛选,enter 应用,esc 清除

日志面板​

键操作备注
e导出日志将日志内容导出到 Downloads 文件夹

标签面板​

键操作场合
< / >切换组件面板在本地分支、标签、远程和 Worktree 之间切换
d删除标签打开删除标签菜单
ctrl+p推送标签打开推送标签菜单
f获取标签打开获取标签菜单
F筛选标签列表输入以筛选,enter 应用,esc 清除
?快捷键和操作说明打开专用帮助弹出窗口

远程操作​

键操作场合
p推送打开推送流程(远程选择 → 推送选项)
P拉取打开拉取流程(拉取类型选择)

远程面板​

键操作场合
< / >切换组件面板在本地分支、标签、远程和 Worktree 之间切换
n新建远程打开添加远程流程
d移除远程移除已配置的远程
e编辑远程打开编辑远程流程
enter设为跟踪上游将当前远程设置为上游
F筛选远程列表输入以筛选,enter 应用,esc 清除
?快捷键和操作说明打开专用帮助弹出窗口

Worktree 面板​

键操作场合
< / >切换组件面板在本地分支、标签、远程和 Worktree 之间切换
enter切换 Worktree切换到选定的 Worktree
n新建 Worktree打开添加 Worktree 流程(名称 + 可选分支)
backspace删除 Worktree打开删除确认弹出窗口
o锁定 / 解锁 Worktree切换锁定状态(主 Worktree 不可用)
ctrl+p修剪 Worktree移除陈旧/丢失的 Worktree 引用
F筛选 Worktree 列表输入以筛选,enter 应用,esc 清除
?快捷键和操作说明打开专用帮助弹出窗口

弹出窗口键位绑定​

文本输入弹出窗口​

适用于:提交、修改提交、添加远程、创建分支、Stash 消息、添加 Worktree、Worktree 锁定原因

键操作备注
ctrl+e提交提交表单(用于多行文本区域)
ctrl+p粘贴从剪贴板粘贴文本
ctrl+y复制将选中的文本复制到剪贴板
enter提交仅适用于单行输入(分支名称、Stash 消息、远程字段)
esc取消不保存关闭弹出窗口
tab下一个字段移动到下一个输入字段(如有多个字段)
shift+tab上一个字段移动到上一个输入字段(如有多个字段)

选择弹出窗口​

适用于:分支类型、切换类型、推送类型、拉取类型、远程选择、丢弃类型、解决冲突类型

键操作备注
↑ 或 k向上导航选择上一个选项
↓ 或 j向下导航选择下一个选项
enter确认选择使用选定选项继续
esc取消不执行操作关闭弹出窗口

输出/结果弹出窗口​

适用于:推送输出、拉取输出、切换分支输出

键操作备注
esc关闭弹出窗口关闭输出弹出窗口

键位绑定帮助弹出窗口​

键操作备注
↑ 或 k向上滚动滚动键位绑定列表
↓ 或 j向下滚动滚动键位绑定列表
esc关闭帮助关闭帮助弹出窗口

详细视图(右侧面板)​

键操作备注
esc返回列表退出详细视图,将焦点返回到列表面板
↑ 或 k向上滚动向上滚动差异内容
↓ 或 j向下滚动向下滚动差异内容
← 或 h向左滚动向左滚动差异内容
→ 或 l向右滚动向右滚动差异内容
[上一个拆分面板切换到暂存/未暂存视图
]下一个拆分面板切换到暂存/未暂存视图
L切换行暂存模式进入/退出单行暂存模式 (查看文件时)
space暂存/取消暂存行暂存/取消暂存选中行(行编辑模式时)
d丢弃行丢弃选中行(行编辑模式时)

总结​

  • * [!!] 键位绑定在任何地方都有效,包括在弹出窗口内
  • * 键位绑定全局有效,但在弹出窗口打开时无效
  • 特定上下文的键位绑定仅在其各自的面板中有效
  • 弹出窗口键位绑定取决于弹出窗口类型(文本输入 vs 选择 vs 输出)
  • **esc**是关闭弹出窗口或退出详细视图的通用方法
  • F 筛选当前聚焦的列表面板,每个列表保留各自的筛选内容
  • 鼠标点击可聚焦面板并选中列表项;滚轮可滚动详细面板和弹出窗口