注意
GitHub 命令面板目前处于公开预览阶段,可能会有所更改。
GitHub 命令面板默认情况下处于禁用状态。您可以使用功能预览启用 GitHub 命令面板。请参阅“探索抢先体验版的功能预览”。
关于 GitHub 命令面板
您可以使用 GitHub 命令面板导航、搜索和运行 GitHub 上的命令。命令面板是一种按需显示建议的方式,这些建议基于您当前的上下文以及您最近使用的资源。您可以从 GitHub 的任何位置使用键盘快捷键打开命令面板,这可以节省您的时间,并让您的双手始终放在键盘上。
快速导航
打开命令面板后,建议会进行优化,以便您可以在仓库、个人帐户或组织中的任何位置轻松访问顶级页面,例如“问题”页面。如果所需位置未列出,请开始输入位置的名称或编号以缩小建议范围。
轻松访问命令
无需遍历一系列菜单即可直接从键盘运行命令的功能可能会改变您使用 GitHub 的方式。例如,您可以通过几个按键切换主题,从而可以根据需要轻松地在主题之间切换。
打开 GitHub 命令面板
使用以下默认键盘快捷键之一打开命令面板
- Windows 和 Linux:Ctrl+K 或 Ctrl+Alt+K
- Mac:Command+K 或 Command+Option+K
您可以在用户设置的辅助功能部分中自定义用于打开命令面板的键盘快捷键。有关更多信息,请参阅“自定义 GitHub 命令面板键盘快捷键”。
打开命令面板时,它会在左上方显示您的位置,并将其用作建议的范围(例如,octo-org
组织)。
注意
- 如果您正在编辑 Markdown 文本,请使用 Ctrl+Alt+K(Windows 和 Linux)或 Command+Option+K(Mac)打开命令面板。
- 如果您正在处理项目,则会显示特定于项目的命令面板。有关更多信息,请参阅“更改视图布局”。
自定义 GitHub 命令面板键盘快捷键
用于打开命令面板的默认键盘快捷键可能与您默认的操作系统和浏览器键盘快捷键冲突。您可以在帐户设置的辅助功能部分中自定义键盘快捷键。在命令面板设置中,您可以自定义在搜索模式和命令模式下打开命令面板的键盘快捷键。
使用 GitHub 命令面板导航
您可以使用命令面板导航到您可以在 GitHub 上访问的任何页面。
-
使用 Ctrl+K(Windows/Linux)或 Command+K(Mac)打开命令面板,其范围由您在 UI 中的当前位置确定。
-
开始键入您要导航到的路径。命令面板中的建议会更改以匹配您的文本。
-
您可以选择通过编辑命令面板的文本字段中的路径来缩小、扩展或完全更改建议的范围。
- 要缩小用户或组织帐户内的范围,请突出显示一个仓库,然后使用 Tab 将其添加到范围。
- 要扩展范围,请使用 Backspace 或 delete 键突出显示并删除范围中的项目。
- 要清除范围和文本框,请单击**清除**或使用 Ctrl+Backspace(Windows 和 Linux)或 Command+Delete(Mac)。
您还可以使用击键来缩小搜索范围。有关更多信息,请参阅“击键功能”。
-
完成路径输入,或使用箭头键从建议列表中突出显示您想要的路径。
-
使用 Enter 跳转到您选择的位置。或者,使用 Ctrl+Enter(Windows 和 Linux)或 Command+Enter(Mac)在新浏览器标签页中打开该位置。
使用 GitHub 命令面板搜索
您可以使用命令面板搜索 GitHub 上的任何内容。
-
使用 Ctrl+K(Windows/Linux)或 Command+K(Mac)打开命令面板,其范围由您在 UI 中的当前位置确定。
-
您可以选择通过编辑命令面板的文本字段中的路径来缩小、扩展或完全更改建议的范围。
- 要缩小用户或组织帐户内的范围,请突出显示一个仓库,然后使用 Tab 将其添加到范围。
- 要扩展范围,请使用 Backspace 或 delete 键突出显示并删除范围中的项目。
- 要清除范围和文本框,请单击**清除**或使用 Ctrl+Backspace(Windows 和 Linux)或 Command+Delete(Mac)。
-
您可以选择使用击键查找特定类型的资源
- # 搜索问题、拉取请求、讨论和项目
- ! 搜索项目
- @ 搜索用户、组织和仓库
- / 搜索仓库范围内的文件
-
开始输入您的搜索词。命令面板会根据您的搜索范围为您提供一系列建议的搜索结果。
您也可以在命令面板中使用 GitHub 集成搜索的完整语法。有关更多信息,请参阅“GitHub 上的搜索文档”。
-
使用箭头键突出显示您想要的搜索结果,然后使用 Enter 跳转到您选择的位置。或者,使用 Ctrl+Enter(Windows 和 Linux)或 Command+Enter(Mac)在新浏览器标签页中打开该位置。
从 GitHub 命令面板运行命令
您可以使用 GitHub 命令面板运行命令。例如,您可以创建新的仓库或问题,或更改主题。运行命令时,其操作位置由底层页面或命令面板中显示的范围确定。
- 拉取请求和问题命令始终在底层页面上运行。
- 更高级别的命令(例如,仓库命令)在命令面板中显示的范围内运行。
有关支持的命令的完整列表,请参阅“GitHub 命令面板参考”。
-
在命令模式下打开命令面板的默认键盘快捷键是 Ctrl+Shift+K(Windows 和 Linux)或 Command+Shift+K(Mac)。如果您已打开命令面板,请按 > 切换到命令模式。GitHub 会根据您的位置建议命令。
-
您可以选择通过编辑命令面板的文本字段中的路径来缩小、扩展或完全更改建议的范围。
- 要缩小用户或组织帐户内的范围,请突出显示一个仓库,然后使用 Tab 将其添加到范围。
- 要扩展范围,请使用 Backspace 或 delete 键突出显示并删除范围中的项目。
- 要清除范围和文本框,请单击**清除**或使用 Ctrl+Backspace(Windows 和 Linux)或 Command+Delete(Mac)。
-
如果未显示所需的命令,请检查您的范围,然后开始在文本框中输入命令名称。
-
使用箭头键突出显示您想要的命令,然后使用 Enter 运行它。
关闭命令面板
命令面板处于活动状态时,您可以使用以下键盘快捷键之一关闭命令面板
- 搜索和导航模式:Esc 或 Ctrl+K(Windows 和 Linux)Command+K(Mac)
- 命令模式:Esc 或 Ctrl+Shift+K(Windows 和 Linux)Command+Shift+K(Mac)
如果您已在辅助功能设置中自定义了命令面板键盘快捷键,则自定义的键盘快捷键将用于打开和关闭命令面板。
GitHub 命令面板参考
击键功能
这些击键在命令面板处于导航和搜索模式时可用,即在命令模式下不可用。
击键 | 功能 |
---|---|
> | 进入命令模式。有关更多信息,请参阅“从 GitHub 命令面板运行命令”。 |
# | 搜索问题、拉取请求、讨论和项目。有关更多信息,请参阅“使用 GitHub 命令面板搜索”。 |
@ | 搜索用户、组织和仓库。有关更多信息,请参阅“使用 GitHub 命令面板搜索”。 |
/ | 搜索仓库范围内的文件或组织范围内的仓库。有关更多信息,请参阅“使用 GitHub 命令面板搜索”。 |
! | 仅搜索项目。有关更多信息,请参阅“使用 GitHub 命令面板搜索”。 |
Ctrl+C 或 Command+C | 将突出显示结果的搜索或导航 URL 复制到剪贴板。 |
Enter | 跳转到突出显示的结果或运行突出显示的命令。 |
Ctrl+Enter 或 Command+Enter | 在新浏览器标签页中打开突出显示的搜索或导航结果。 |
? | 在命令面板中显示帮助。 |
全局命令
这些命令可在所有范围内使用。
命令 | 行为 |
---|---|
导入仓库 | 通过从另一个版本控制系统导入项目来创建一个新的仓库。有关更多信息,请参阅“使用 GitHub Importer 导入仓库”。 |
新建 gist | 打开一个新的 gist。有关更多信息,请参阅“创建 gist”。 |
新建组织 | 创建一个新的组织。有关更多信息,请参阅“从头开始创建新的组织”。 |
新建项目 | 创建一个新的项目。有关更多信息,请参阅“创建项目”。 |
新建仓库 | 从头开始创建一个新的仓库。有关更多信息,请参阅“创建新的仓库”。 |
切换到 | 直接更改 UI 的主题。有关更多信息,请参阅“管理您的主题设置”。 |
组织命令
这些命令仅在组织范围内可用。
命令 | 行为 |
---|---|
新建团队 | 在当前组织中创建一个新的团队。有关更多信息,请参阅“创建团队”。 |
仓库命令
大多数这些命令仅在仓库的主页上可用。如果某个命令在其他页面上也可用,则会在行为列中注明。
命令 | 行为 |
---|---|
克隆仓库: | 将使用 GitHub CLI、HTTPS 或 SSH 克隆仓库所需的 URL 复制到剪贴板。有关更多信息,请参阅“克隆仓库”。 |
新建讨论 | 在仓库中创建一个新的讨论。有关更多信息,请参阅“GitHub 讨论快速入门”。 |
新建文件 | 在仓库中的任何页面创建新文件。有关更多信息,请参阅“向仓库添加文件”。 |
新建问题 | 在仓库中的任何页面打开一个新的问题。有关更多信息,请参阅“创建问题”。 |
在 github.dev 编辑器中打开 | 在 github.dev 编辑器中打开当前仓库。有关更多信息,请参阅“基于 Web 的 github.dev 编辑器”。 |
文件命令
这些命令仅在您从仓库中的文件打开命令面板时可用。
命令 | 行为 |
---|---|
复制永久链接 | 创建指向包含当前提交 SHA 的文件的链接,并将链接复制到剪贴板。更多信息,请参见“获取文件的永久链接”。 |
在 github.dev 编辑器中打开 | 在 github.dev 编辑器中打开当前显示的文件。更多信息,请参见“基于 Web 的 github.dev 编辑器”。 |
讨论命令
这些命令仅在您从讨论中打开命令面板时可用。它们作用于您当前的页面,不受命令面板中设置的范围的影响。
命令 | 行为 |
---|---|
删除讨论… | 永久删除讨论。更多信息,请参见“管理讨论”。 |
编辑讨论正文 | 打开讨论的主体以便编辑。 |
订阅 /取消订阅 | 选择加入或退出讨论新增内容的通知。更多信息,请参见“关于通知”。 |
转移讨论… | 将讨论移至不同的仓库。更多信息,请参见“管理讨论”。 |
问题命令
这些命令仅在您从问题中打开命令面板时可用。它们作用于您当前的页面,不受命令面板中设置的范围的影响。
命令 | 行为 |
---|---|
关闭 /重新打开问题 | 关闭或重新打开当前问题。更多信息,请参见“关于问题”。 |
将问题转换为讨论… | 将当前问题转换为讨论。更多信息,请参见“审核讨论”。 |
删除问题… | 删除当前问题。更多信息,请参见“删除问题”。 |
编辑问题正文 | 打开问题的主体以便编辑。 |
编辑问题标题 | 打开问题标题以便编辑。 |
锁定问题 | 将新评论限制为对仓库具有写入权限的用户。更多信息,请参见“锁定对话”。 |
Pin /取消Pin问题 | 更改问题是否显示在仓库的 Pinned 问题部分。更多信息,请参见“将问题 Pin 到您的仓库”。 |
订阅 /取消订阅 | 选择加入或退出此问题的更改通知。更多信息,请参见“关于通知”。 |
转移问题… | 将问题转移到另一个仓库。更多信息,请参见“将问题转移到另一个仓库”。 |
拉取请求命令
这些命令仅在您从拉取请求中打开命令面板时可用。它们作用于您当前的页面,不受命令面板中设置的范围的影响。
命令 | 行为 |
---|---|
关闭 /重新打开拉取请求 | 关闭或重新打开当前拉取请求。更多信息,请参见“关于拉取请求”。 |
转换为草稿 /标记拉取请求为已准备好审查 | 更改拉取请求的状态以显示其是否已准备好审查。更多信息,请参见“更改拉取请求的阶段”。 |
复制当前分支名称 | 将拉取请求的 HEAD 分支名称添加到剪贴板。 |
编辑拉取请求正文 | 打开拉取请求的主体以便编辑。 |
编辑拉取请求标题 | 打开拉取请求的标题以便编辑。 |
订阅 /取消订阅 | 选择加入或退出此拉取请求更改的通知。更多信息,请参见“关于通知”。 |
更新当前分支 | 使用来自基分支的更改更新拉取请求的 HEAD 分支。此功能仅适用于针对仓库默认分支的拉取请求。更多信息,请参见“关于分支”。 |