GitHub CLI：命令行GitHub指南

GitHub CLI 快速入门指南：告别浏览器，命令行掌控你的 GitHub

本文将带你快速上手 GitHub CLI，了解其用途、设置方法和使用方法。

如果你熟悉 Git 命令，你肯定知道需要切换到网页浏览器才能在 GitHub 仓库上执行各种操作。而新的 GitHub CLI 工具，则允许你在不离开命令行界面的情况下执行许多这些操作。

核心要点

• GitHub CLI 允许用户在不离开命令行界面的情况下，对 GitHub 仓库执行各种操作，无需切换到网页浏览器。
• GitHub CLI 命令结构类似树状，包含两层：第一层包含六个命令：config、repo、issue、pr、gist 和 credits。每个命令都有第二层，用户可以在其中指定要执行的操作。
• GitHub CLI 允许用户直接从命令行克隆、fork、查看和创建仓库。它还包括用于创建和管理拉取请求、问题和 gist 的命令。
• 尽管 GitHub CLI 是一个强大的 GitHub 仓库管理工具，但需要注意的是，它仍在开发中，新的命令可能会随着时间的推移而出现。建议用户参考手册了解新功能以及如何使用现有工具。

GitHub CLI 设置

要开始使用，只需访问安装页面，查找适用于你的操作系统的 GitHub CLI 安装说明。对于 Windows 和 macOS，可以使用包管理器来安装和更新 GitHub CLI。对于 Linux 用户，需要从最新发布页面下载软件包。Windows 用户也有带签名的 MSI 安装程序，但请注意，如果你选择此方法，则必须手动重新下载和更新工具。对于 Windows 用户，最简单的方法是使用 scoop 包管理器。

以下是每个支持平台的安装说明：

• Windows：

<code>scoop bucket add github-gh https://github.com/cli/scoop-gh.git
scoop install gh</code>

• macOS：

<code>brew install gh</code>

• Debian/Ubuntu Linux：

<code>sudo apt install git && sudo dpkg -i gh_*_linux_amd64.deb</code>

• Fedora/Centos Linux：

<code>sudo yum localinstall gh_*_linux_amd64.rpm</code>

• Arch Linux：

<code>yay -S github-cli</code>

在 Windows 上，我建议使用 Git Bash 终端。此界面将允许你访问常用的 Linux 命令和 Bash 功能，例如自动完成。它也通过终端集成得到 Visual Studio Code 的官方支持。

安装 GitHub CLI 后，需要验证你的帐户。运行任何命令都会触发此身份验证过程。例如，尝试 gh repo view cli/cli。对于首次使用的用户，系统会提示你：

只需按 Enter 键即可开始此过程，如下所示：

提供密码后，你将收到“成功验证 GitHub CLI”的消息。你现在可以通过命令行终端与 GitHub 平台进行交互。下一步是实现自动完成，这是可选的。只需将此行添加到你的 ~/.bash_profile：

<code>scoop bucket add github-gh https://github.com/cli/scoop-gh.git
scoop install gh</code>

你也可以在当前终端中运行上述命令来获得自动完成功能，而无需重新启动终端。要确认它是否有效，键入 gh repo，然后按 tab 两次。它应该显示你可以附加到当前 repo 命令的四个不同的命令。

GitHub CLI 命令结构

gh 命令结构类似树状，易于记忆。基本上只有两层命令。第一层仅包含六个命令：

• config
• repo
• issue
• pr
• gist
• credits

每个命令都有第二层命令，你可以在其中指定要执行的操作，例如 gh repo view 或 gh pr list。但是，credits 命令没有第二层命令。执行时，它只会列出存储库贡献者的姓名。以下是一个你可以自己尝试的快速示例：

<code>brew install gh</code>

我们将在接下来的部分更详细地介绍其余命令。

GitHub 仓库命令

使用 gh 命令克隆仓库比使用 git 命令更容易。要克隆，只需按以下格式执行命令：

<code>sudo apt install git && sudo dpkg -i gh_*_linux_amd64.deb</code>

此格式使从内存中克隆更容易。你不再需要键入或复制粘贴长的 Git URL 来克隆。以下是一个示例：

<code>sudo yum localinstall gh_*_linux_amd64.rpm</code>

你还可以轻松地从命令行将现有仓库 fork 到你的帐户。试试这个：

<code>yay -S github-cli</code>

在 fork 过程中，工具会询问你是否也想要克隆。如果你说“是”，它将执行克隆，设置远程上游分支并为你自动执行更新。这非常方便。你可以通过在命令行中检查仓库的配置来确认这一点：git config -e。以下是我的输出：

eval "$(gh completion -s bash)"

对于此项目，trunk 是默认分支。你需要使用 git 命令像往常一样同步你的 fork 仓库。对于 cli 仓库：

$ gh credits cli/cli

你还可以使用 gh repo view 命令查看托管在 GitHub 上的项目的描述和自述文件。尝试此命令：

gh repo clone OWNER/REPO

到目前为止，你已经学习了如何使用 gh repo 命令进行克隆、fork 和查看。让我们从命令行创建一个新的 GitHub 仓库。首先，我们需要创建一个新项目。让我们快速生成一个 Next.js 项目。当被询问时，使用“默认入门应用程序”模板：

$ gh repo clone tailwindcss/tailwindcss

你会发现该项目的本地 Git 仓库已经初始化。要从命令行创建仓库，只需运行以下命令：

<code>scoop bucket add github-gh https://github.com/cli/scoop-gh.git
scoop install gh</code>

如果你没有指定 --public 选项，则默认情况下会创建一个私有仓库。以下是你可以指定的标志的完整列表：

<code>brew install gh</code>

如果你想在不同的组织下创建仓库，则需要使用以下语法来创建仓库：gh repo create org/repo。

(其余部分，关于Pull Request, Issue, Gist 命令以及总结和FAQ，由于篇幅限制，请分段提问，我会逐一详细解答。)

以上是GitHub CLI：命令行GitHub指南的详细内容。更多信息请关注PHP中文网其他相关文章！