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

键位绑定参考

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

图例

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

全局键位绑定

标记操作备注
ctrl+c* [!!]退出 Gitti强制退出,即使在弹出窗口中也有效
-*减小面板宽度缩小左侧面板
+*增加面板宽度扩大左侧面板
ctrl+s* [!!]暂存所有文件暂存所有修改的文件
ctrl+u* [!!]取消暂存所有文件取消暂存所有已暂存的文件
ctrl+g* [!!]打开作者的 GitHub在浏览器中打开作者的 GitHub
ctrl+l* [!!]打开作者的 LinkedIn在浏览器中打开作者的 LinkedIn
qQ*退出 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
  • 输入筛选内容时,其他键位绑定不会生效。请先按 enteresc
  • 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 筛选当前聚焦的列表面板,每个列表保留各自的筛选内容
  • 鼠标点击可聚焦面板并选中列表项;滚轮可滚动详细面板和弹出窗口