GitHub 命令面板

关于 GitHub 命令面板

您可以使用 GitHub 命令面板在 GitHub 上导航、搜索和运行命令。命令面板是一种按需方式，可以根据您当前的上下文和最近使用过的资源显示建议。您可以从 GitHub 上的任何位置使用键盘快捷键打开命令面板，这可以节省您的时间并让您的双手保持在键盘上。

快速导航

当您打开命令面板时，建议会经过优化，让您能够从存储库、个人帐户或组织中的任何位置轻松访问顶级页面，例如问题页面。如果您想要的位置未列出，请开始输入该位置的名称或编号以细化建议。

轻松访问命令

能够直接从键盘运行命令，而无需通过一系列菜单进行导航，可能会改变您使用 GitHub 的方式。例如，您可以使用几个按键切换主题，从而可以轻松地在主题之间切换以满足您的需求变化。

打开 GitHub 命令面板

使用以下默认键盘快捷键之一打开命令面板

• Windows 和 Linux：Ctrl+K 或 Ctrl+Alt+K
• Mac：Command+K 或 Command+Option+K

您可以在用户设置的辅助功能部分中自定义用于打开命令面板的键盘快捷键。有关更多信息，请参阅“自定义 GitHub 命令面板键盘快捷键”。

当您打开命令面板时，它会在左上角显示您的位置，并将其用作建议的范围（例如，octo-org 组织）。

自定义 GitHub 命令面板键盘快捷键

用于打开命令面板的默认键盘快捷键可能会与您的默认操作系统和浏览器键盘快捷键冲突。您可以在帐户设置的辅助功能部分中自定义键盘快捷键。在命令面板设置中，您可以自定义在搜索模式和命令模式下打开命令面板的键盘快捷键。

使用 GitHub 命令面板导航

您可以使用命令面板导航到您在 GitHub 上有权访问的任何页面。

1. 使用 Ctrl+K（Windows/Linux）或 Command+K（Mac）打开命令面板，其范围由您在 UI 中的当前位置决定。

2. 开始输入您要导航到的路径。命令面板中的建议会更改以匹配您的文本。

3. 可选地，通过编辑命令面板文本字段中的路径来缩小、扩展或完全更改建议范围。

   • 要缩小用户或组织帐户内的范围，请突出显示一个存储库，然后使用 Tab 将其添加到范围中。
   • 要扩展范围，请使用 Backspace 或 delete 键突出显示并删除范围中的项目。
   • 要清除范围和文本框，请单击清除或使用 Ctrl+Backspace（Windows 和 Linux）或 Command+Delete（Mac）。

   您也可以使用按键来缩小搜索范围。有关更多信息，请参阅“按键功能”。

4. 完成输入路径，或使用箭头键从建议列表中突出显示您想要的路径。

5. 使用 Enter 跳转到您选择的位置。或者，使用 Ctrl+Enter（Windows 和 Linux）或 Command+Enter（Mac）在新浏览器选项卡中打开该位置。

使用 GitHub 命令面板搜索

您可以使用命令面板搜索 GitHub.com 上的任何内容。

1. 使用 Ctrl+K（Windows/Linux）或 Command+K（Mac）打开命令面板，其范围由您在 UI 中的当前位置决定。

2. 可选地，通过编辑命令面板文本字段中的路径来缩小、扩展或完全更改建议范围。

   • 要缩小用户或组织帐户内的范围，请突出显示一个存储库，然后使用 Tab 将其添加到范围中。
   • 要扩展范围，请使用 Backspace 或 delete 键突出显示并删除范围中的项目。
   • 要清除范围和文本框，请单击清除或使用 Ctrl+Backspace（Windows 和 Linux）或 Command+Delete（Mac）。

3. 可选地，使用按键查找特定类型的资源

   • # 搜索问题、拉取请求、讨论和项目
   • ! 搜索项目
   • @ 搜索用户、组织和仓库
   • / 在仓库范围内搜索文件

4. 开始输入您的搜索词。命令面板会根据您的搜索范围提供一系列建议搜索。

   您也可以在命令面板中使用 GitHub 集成搜索的完整语法。有关更多信息，请参阅“GitHub 上的搜索文档”。

5. 使用箭头键突出显示您想要的搜索结果，然后使用 Enter 跳转到您选择的位置。或者，使用 Ctrl+Enter（Windows 和 Linux）或 Command+Enter（Mac）在新浏览器选项卡中打开该位置。

从 GitHub 命令面板运行命令

您可以使用 GitHub 命令面板运行命令。例如，您可以创建新的仓库或问题，或更改主题。当您运行命令时，其操作位置由基础页面或命令面板中显示的范围决定。

• 拉取请求和问题命令始终在基础页面上运行。
• 更高级别的命令（例如仓库命令）在命令面板中显示的范围内运行。

有关支持命令的完整列表，请参阅“GitHub 命令面板参考”。

1. 在命令模式下打开命令面板的默认键盘快捷键是 Ctrl+Shift+K（Windows 和 Linux）或 Command+Shift+K（Mac）。如果您已经打开了命令面板，请按 > 切换到命令模式。GitHub 会根据您的位置建议命令。

2. 可选地，通过编辑命令面板文本字段中的路径来缩小、扩展或完全更改建议范围。

   • 要缩小用户或组织帐户内的范围，请突出显示一个存储库，然后使用 Tab 将其添加到范围中。
   • 要扩展范围，请使用 Backspace 或 delete 键突出显示并删除范围中的项目。
   • 要清除范围和文本框，请单击清除或使用 Ctrl+Backspace（Windows 和 Linux）或 Command+Delete（Mac）。

3. 如果您想要的命令未显示，请检查您的范围，然后在文本框中开始输入命令名称。

4. 使用箭头键突出显示您想要的命令，然后使用 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 的主题。有关更多信息，请参阅“管理主题设置”。

组织命令

这些命令仅在组织范围内可用。

命令	行为
新建团队	在当前组织中创建一个新的团队。有关更多信息，请参阅“创建团队”。

仓库命令

大多数这些命令仅在仓库主页上可用。如果某个命令在其他页面上也可用，则会在行为列中注明。

命令	行为
克隆仓库：<URL 类型>	复制使用 GitHub CLI、HTTPS 或 SSH 克隆仓库所需的 URL 到剪贴板。有关更多信息，请参阅“克隆仓库”。
新建讨论	在仓库中创建一个新的讨论。有关更多信息，请参阅“GitHub 讨论快速入门”。
新建文件	从仓库中的任何页面创建一个新的文件。有关更多信息，请参阅“向仓库添加文件”。
新建问题	从仓库中的任何页面打开一个新的问题。有关更多信息，请参阅“创建问题”。
在 github.dev 编辑器中打开	在 github.dev 编辑器中打开当前仓库。有关更多信息，请参阅“github.dev 基于 Web 的编辑器”。

文件命令

这些命令仅在您从存储库中的文件打开命令面板时可用。

命令	行为
复制永久链接	创建一个包含当前提交 SHA 的文件链接，并将链接复制到剪贴板。有关更多信息，请参阅“获取文件永久链接”。
在 github.dev 编辑器中打开	在 github.dev 编辑器中打开当前显示的文件。有关更多信息，请参阅“基于 Web 的 github.dev 编辑器”。

讨论命令

这些命令仅在您从讨论中打开命令面板时可用。它们作用于当前页面，不受命令面板中设置的范围影响。

命令	行为
删除讨论...	永久删除讨论。有关更多信息，请参阅“管理讨论”。
编辑讨论正文	打开讨论的主体，准备编辑。
订阅/取消订阅	选择加入或退出讨论新增内容的通知。有关更多信息，请参阅“关于通知”。
转移讨论...	将讨论移至另一个存储库。有关更多信息，请参阅“管理讨论”。

问题命令

这些命令仅在您从问题中打开命令面板时可用。它们作用于当前页面，不受命令面板中设置的范围影响。

命令	行为
关闭/重新打开问题	关闭或重新打开当前问题。有关更多信息，请参阅“关于问题”。
将问题转换为讨论...	将当前问题转换为讨论。有关更多信息，请参阅“审核讨论”。
删除问题...	删除当前问题。有关更多信息，请参阅“删除问题”。
编辑问题正文	打开问题的正文以供编辑。
编辑问题标题	打开问题的标题以供编辑。
锁定问题	将新评论限制为具有仓库写入权限的用户。有关更多信息，请参阅“锁定对话”。
Pin/取消固定问题	更改问题是否显示在仓库的固定问题部分。有关更多信息，请参阅“将问题固定到仓库”。
订阅/取消订阅	选择是否接收此问题的更改通知。有关更多信息，请参阅“关于通知”。
转移问题...	将问题转移到另一个仓库。有关更多信息，请参阅“将问题转移到另一个仓库”。

拉取请求命令

这些命令仅在您从拉取请求中打开命令面板时可用。它们作用于当前页面，不受命令面板中设置的范围影响。

命令	行为
关闭/重新打开拉取请求	关闭或重新打开当前拉取请求。有关更多信息，请参阅“关于拉取请求”。
转换为草稿/将拉取请求标记为已准备好审查	更改拉取请求的状态，以显示它是否已准备好审查。有关更多信息，请参阅“更改拉取请求的阶段”。
复制当前分支名称	将拉取请求的头部分支名称添加到剪贴板。
编辑拉取请求正文	打开拉取请求的主体，准备编辑。
编辑拉取请求标题	打开拉取请求的标题，准备编辑。
订阅/取消订阅	选择是否接收此拉取请求更改的通知。有关更多信息，请参阅“关于通知”。
更新当前分支	使用来自基分支的更改更新拉取请求的头部分支。此功能仅适用于针对存储库默认分支的拉取请求。有关更多信息，请参阅“关于分支”。