GitLab 快捷键速查表 - 代码托管平台常用快捷键大全
GitLab 的快捷键在细节上跟 GitHub 不尽相同，而审阅流程正是它最省时的地方。本表覆盖全局导航、仓库/文件搜索、Issue/MR 快捷键，以及 Merge Request 的审查与评论。团队统一用自建 GitLab CE/EE、想以键盘优先完成 review 和 MR 分流时最适用。读完能用键盘在项目、文件与 MR 线程之间穿梭，跟鼠标一样快却少了很多来回点。
典型使用场景
面向每天在 GitLab 上做代码评审与合并请求的工程师。GitLab 的 Web 界面提供了完整的键盘优先操作方式，熟悉之后处理 issue、MR 和代码审查的速度可以接近本地终端。本表按区域组织：全局导航用 G 前缀的组合键（Gd 仪表盘、Ga 活动、Gm 里程碑、Gi Issues、Gl 合并请求、Gp 项目、Gs 代码片段）与 S 或 / 搜索；仓库浏览用 T 打开模糊匹配的文件查找器、Y 把当前 URL 转换成固定 commit 版本便于分享、W 切换分支标签选择器；代码浏览用 1-9 直达行号与 Cmd + F / Cmd + G 系列搜索；MR 与审查部分覆盖 Cmd + Enter 提交评论、Cmd + Option + Enter 关闭并评论，以及单行/多行/待办评论的快捷键；最后是 Markdown 编辑全套格式快捷键。按 ? 随时调出帮助。
全局导航 9
G then DG then AG then MG then IG then LG then PG then SS or /?仓库浏览 8
TYWBIPCU代码浏览 7
1-9Cmd + /Cmd + FCmd + GCmd + Shift + GCmd + Shift + FCmd + Shift + PIssue 与 MR 11
CCmd + EnterCmd + Option + EnterCmd + Shift + PCmd + BCmd + ICmd + KCmd + Option + ICmd + Shift + 7Cmd + Shift + 8Cmd + Shift + 9代码审查 6
Cmd + EnterCmd + Option + EnterCmd + Shift + EnterCmd + Shift + 7Cmd + Shift + 8Cmd + Shift + 9Markdown 编辑 10
Cmd + BCmd + ICmd + KCmd + Option + ICmd + Shift + 7Cmd + Shift + 8Cmd + Shift + 9Cmd + Shift + .Cmd + Shift + CCmd + Shift + H参数矩阵
| 参数 | 作用 | 示例 |
|---|---|---|
G then D | 跳转到仪表盘 | G 然后 D |
G then A | 跳转到活动页面 | G 然后 A |
G then M | 跳转到里程碑 | G 然后 M |
G then I | 跳转到 Issues 页面 | G 然后 I |
G then L | 跳转到合并请求页面 | G 然后 L |
G then P / G then S | 跳转到项目 / 代码片段 | G 然后 P |
S 或 / | 搜索 | 按 S |
? | 显示快捷键帮助 | 按 ? |
T | 打开文件查找器，支持文件名模糊匹配 | 按 T |
Y | 把当前 URL 转换为固定版本（commit）便于分享 | 按 Y |
W | 切换到分支/标签选择器 | 按 W |
B / I / P / C / U | Issue 模板 / Issue 列表 / MR 列表 / 新建文件 / 返回上级目录 | 按 I |
1-9 | 跳转到文件对应行号 | 按 5 |
Cmd + / | 切换行注释 | Cmd + / |
Cmd + F / Cmd + G | 文件内搜索 / 跳到下一个匹配 | Cmd + G |
Cmd + Shift + G | 跳到上一个匹配 | Cmd + Shift + G |
Cmd + Shift + F | 全局搜索 | Cmd + Shift + F |
Cmd + Shift + P | 打开命令面板（并在编辑器中切换预览/编辑） | Cmd + Shift + P |
C | 创建新 Issue / MR | 按 C |
Cmd + Enter | 提交评论 / 提交审查 | Cmd + Enter |
Cmd + Option + Enter | 关闭并评论 / 批准 MR | Cmd + Option + Enter |
Cmd + Shift + Enter | 请求更改 | Cmd + Shift + Enter |
Cmd + Shift + 7 / 8 / 9 | 添加单行 / 多行 / 待办评论（编辑器内亦为有序/无序/任务列表） | Cmd + Shift + 7 |
Cmd + B / Cmd + I / Cmd + K | 加粗 / 斜体 / 插入链接 | Cmd + K |
Cmd + Option + I | 插入图片 | Cmd + Option + I |
Cmd + Shift + C / H / . | 代码块 / 标题 / 引用 | Cmd + Shift + C |
易错点与避坑指南
现象按 G 之后没有任何反应，没有跳到任何页面
原因组合键有时间窗口，G 与第二个字母必须连续按，中间隔太久就失效。
处置连续快速按 G 再按目标字母；不确定对应哪个页面时按 ? 调出帮助页对照。
现象想给同事看某段代码，对方打开后看到的是最新代码而不是自己那份
原因直接复制了仓库根地址，URL 指向的是会变动的分支引用。
处置在代码页按 Y，把 URL 转换成固定版本（commit hash）后再分享。
现象评论敲了一大段，误触某个键格式全乱、提交后没法直接改
原因编辑态与预览态共享同一批快捷键，且列表/引用类快捷键用得比想象中频繁。
处置用 Cmd + Shift + P 在预览/编辑之间切换确认排版；提交后仍有修改机会，尽早 Cmd + Enter 提交评论。
现象想给 MR 留一条针对某行的评论，却新建成了整个文件的评论
原因审查评论的三种形态由不同快捷键区分：单行、多行、待办。
处置单行评论用 Cmd + Shift + 7，多行评论用 Cmd + Shift + 8，待办评论用 Cmd + Shift + 9。
现象在一个大文件里靠方向键翻找具体代码，效率极低
原因没有用行号直达与搜索跳转。
处置用 1-9 直达对应行号，用 Cmd + F 搜索文件内容、Cmd + G / Cmd + Shift + G 在匹配间前后跳转。
现象按 Cmd + Enter 后既没发评论也没进审查结论
原因在不同上下文里 Cmd + Enter 的语义不同：编辑器里是提交评论，审查面板里是提交审查结论。
处置确认当前焦点在评论框还是审查面板——评论框提交评论，审查面板提交结论，批准则用 Cmd + Option + Enter。
排障路径
1查当前页面的完整快捷键帮助
按 ? 键帮助内容随所在区域变化（仓库浏览、MR、编辑器各不相同），是最权威的对照表。
2打开文件查找器快速定位文件
按 T 后输入文件名的部分字母支持模糊匹配，比在目录树里逐层点击快很多。
3打开命令面板执行动作
按 Cmd + Shift + P 后输入动作名快捷键记不住时统一从这里找；面板同时也是确认某动作当前是否可用的方法。
4把当前 URL 固定为不可变版本
按 Y 键后复制地址栏得到的链接带 commit hash，收件人看到的一定是你分享时的那份代码。
5在文件内定位并循环匹配
按 Cmd + F 输入关键词，再按 Cmd + G 前进、Cmd + Shift + G 后退反复命中同一关键词时用后两个键在匹配之间往返，比重复开搜索框快。
命令示例
评论框里用 Markdown 快捷键而不是手打符号
Cmd + B // 加粗
Cmd + I // 斜体
Cmd + K // 插入链接
Cmd + Shift + 7 // 有序列表
Cmd + Shift + 8 // 无序列表
Cmd + Shift + 9 // 任务列表GitLab 的评论框本身就渲染 Markdown，写评审意见时用快捷键比切回编辑符号再粘贴快得多。Cmd + Shift + 9 插入的任务列表项可以直接勾选，评审人把待办标出来比用文字描述「记得跟进」有效。
提交审查的三种落点
Cmd + Enter // 提交审查
Cmd + Option + Enter // 批准 MR
Cmd + Shift + Enter // 请求更改三种结果对流水线与合并规则的影响完全不同：批准可能直接满足合并条件，请求更改会挡住合并。因此点击前确认自己要表达的是哪一种，不要把「提交评论」顺手按成「批准」。
审查时添加单行 / 多行 / 待办评论
Cmd + Shift + 7 // 添加单行评论
Cmd + Shift + 8 // 添加多行评论
Cmd + Shift + 9 // 添加待办评论这三个键的语义随上下文切换：在编辑框里是插入列表，在 diff 视图里是挂评论。审查时用它们可以把意见精确钉在具体行上，行号会随 diff 变化自动跟随，这比在评论正文里手写「第 42 行」可靠得多。
固定链接：把可变的分支 URL 变成永久版本
Y // 将当前 URL 转换为固定版本默认的分支/标签页面 URL 会随分支推进而变化。把这个 URL 贴进 Issue、MR 描述或事故记录里，几个月后别人打开看到的是另一份代码。转成固定版本后再引用，讨论才不会错位。
纯键盘在代码文件里跳到某一行
T // 打开文件查找器
1-9 // 跳转到对应行号
Cmd + / // 切换行注释文件查找器按文件名模糊匹配，回车即开；打开后 1-9 直接跳到行号，Cmd + / 切换行注释。这套组合在读大文件、做临时注释时省掉反复滚动与鼠标定位。
常见坑与注意事项
- .gitlab-ci.yml 必须用空格缩进：YAML 解析器遇到 tab 会直接报 syntax error，流水线整体不执行，且报错信息通常不指出是哪个文件。
- force push 会覆盖别人已经推到同一分支的提交，且这些提交只能靠 reflog 抢救；共享分支上先 git fetch 再确认，或一律走 MR。
- protected branch 上只有 Maintainer / Owner 能 force push 或删除分支，开发者强推会被拒绝，配置权限前别指望所有人都能救场。
- MR 合并后 CI 才失败就必须 revert 而不是再改一行：直接往已合并分支追加修复提交，历史会变得难以追溯。
- Cmd + Enter 与 Cmd + Option + Enter 相邻：在评论框里顺手按下后者会直接批准 MR，评审意见还没写完就已生效。
- CI 里缓存与依赖固定写成 latest 之类的可变标签时，流水线结果不可复现；出问题时无法判断是代码改动还是依赖漂移。
提示
- T 键打开文件查找器，比鼠标点击快很多，支持模糊匹配文件名。
- Y 键将 URL 转换为固定版本（commit hash），方便分享特定版本的代码。
- Cmd + Enter 提交评论，Cmd + Option + Enter 关闭并评论，不用点击按钮。
- 代码审查时，Cmd + Shift + 7 可以快速添加单行评论。
- Markdown 编辑器支持 Cmd + B 加粗、Cmd + I 斜体、Cmd + K 插入链接。
- ? 键显示所有快捷键帮助，随时查看。
常见问题
GitLab 网页端的 G 键导航怎么用？
先按 G 再按第二个字母，两步组合跳转：G 然后 D 进仪表盘，G 然后 A 进活动页，G 然后 M 看里程碑，G 然后 I 打开 Issues，G then L 进合并请求页，G 然后 P 打开项目页，G 然后 S 打开代码片段页。任意页面按 ? 都能调出完整快捷键帮助。不记得映射时先按 ? 比死记更省事。全局搜索用 S 或 /。
在文件树上快速找文件，除了 T 还有什么？
T 打开文件查找器，支持模糊匹配文件名，比逐层点目录快得多。W 切换到分支/标签选择器，用来确认当前在看哪个版本；Y 把当前 URL 转换成固定版本（commit hash），分享给同事时对方看到的内容和你完全一致。U 返回上一级目录；1-9 键在文件内直接跳到对应行号。B 打开 Issue 模板，I 和 P 分别列出 Issue 与合并请求，C 新建文件。
写评论和写 Issue 时，Markdown 快捷键有哪些？
编辑器里 Cmd + B 加粗、Cmd + I 斜体、Cmd + K 插入链接、Cmd + Option + I 插入图片；列表类用 Cmd + Shift + 7（有序）、Cmd + Shift + 8（无序）、Cmd + Shift + 9（任务列表）。排版还有 Cmd + Shift + H 标题、Cmd + Shift + C 代码块、Cmd + Shift + . 引用。提交评论按 Cmd + Enter，关闭并评论按 Cmd + Option + Enter，连点按钮都省了。Cmd + Shift + P 切换预览/编辑。
评审合并请求时，怎么快速给出结论？
提交审查意见按 Cmd + Enter；表示通过用 Cmd + Option + Enter 直接批准 MR；要求修改用 Cmd + Shift + Enter。逐行留评论时，Cmd + Shift + 7 添加单行评论，Cmd + Shift + 8 添加多行评论，Cmd + Shift + 9 添加待办评论。代码浏览侧配合 Cmd + Shift + F 做全局搜索定位上下文，Cmd + / 切换行注释。
在 GitLab 里找文件和搜索代码内容有什么区别？
T 打开的是文件查找器，只按文件名模糊匹配，用来定位「哪个文件」；Cmd + F 搜的是当前文件内的内容，Cmd + Shift + F 才是跨整个仓库的全局内容搜索。匹配结果之间用 Cmd + G 跳到下一个、Cmd + Shift + G 回到上一个，搜长文件时不用重新开搜索框。不想逐个按就用 Cmd + Shift + P 打开命令面板直接搜动作名。
由 巧匠 维护
公开更新于 2026年7月21日，内容持续校对官方文档。