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。以下是我的輸出：

<code class="language-bash">eval "$(gh completion -s bash)"</code>

對於此項目，trunk 是默認分支。你需要使用 git 命令像往常一樣同步你的 fork 倉庫。對於 cli 倉庫：

<code class="language-bash">$ gh credits cli/cli</code>

你還可以使用 gh repo view 命令查看託管在 GitHub 上的項目的描述和自述文件。嘗試此命令：

<code class="language-bash">gh repo clone OWNER/REPO</code>

到目前為止，你已經學習瞭如何使用 gh repo 命令進行克隆、fork 和查看。讓我們從命令行創建一個新的 GitHub 倉庫。首先，我們需要創建一個新項目。讓我們快速生成一個 Next.js 項目。當被詢問時，使用“默認入門應用程序”模板：

<code class="language-bash">$ gh repo clone tailwindcss/tailwindcss</code>

你會發現該項目的本地 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中文網其他相關文章！