作为开发者，我们经常会发现自己在浏览器和终端之间频繁切换。我们在浏览器中审核 Pull Request，然后切回终端拉取代码；我们在网页上创建 Issue，然后再在本地编写修复代码。这种不断的上下文切换不仅打断了心流，还浪费了宝贵的时间。你有没有想过，如果能把整个 GitHub 的体验都搬到终端里，那该有多好？
在这篇文章中，我们将深入探讨 GitHub CLI（也称为 gh），这是一款能让我们直接在命令行中与 GitHub 交互的强大工具。我们将从基础概念讲起，逐步深入到高级用法和脚本编写，帮助你通过命令行彻底释放开发效率。让我们一起开启这次终端开发体验的升级之旅吧。
目录
什么是 GitHub CLI？
GitHub CLI 是 GitHub 官方推出的一款开源命令行工具。简单来说，它将我们在 GitHub 网页端（Web UI）能做的大部分操作，完美地映射到了命令行界面中。它就像是一座桥梁，连接了我们本地的开发环境与远程的 GitHub 生态。
有了它，我们不再需要依赖图形界面来管理仓库、处理议题或触发 CI/CD 流程。它不仅仅是 Git 的补充，更是我们工作流中的一位全能助手。无论是快速查看一个 PR 的状态，还是管理复杂的 Actions 工作流，GitHub CLI 都能让我们在不离开终端的情况下，行云流水般完成任务。
为什么我们需要在终端中使用 GitHub？
在深入技术细节之前，让我们先聊聊为什么“命令行化”的工作流如此重要。对于许多资深开发者而言，终端不仅是执行命令的地方，更是控制中心。
核心优势
- 心流状态的保护：频繁地切换窗口会打断我们的思路。使用 CLI，我们可以保持在“黑客模式”中，双手不离键盘，思维不中断。
- 极致的效率：想象一下，创建一个带有标题、描述和标签的 Issue，在网页上需要点击多少次鼠标？而在 CLI 中，这只是一行命令的事情。
- 自动化与脚本化：这是 CLI 最大的杀手锏。我们可以将 GitHub 操作融入到我们的 Shell 脚本中，实现真正的自动化部署和管理。
- 统一的开发体验：Git 操作与 GitHub 操作的界限变得模糊。你可以在推送代码后立即查看 CI 状态，这种连贯性是网页版无法比拟的。
主要功能概览
让我们来看看 GitHub CLI 提供了哪些核心功能，以便你对其能力有一个初步的认识：
- 全方位的仓库管理：不仅仅是克隆，我们还可以创建、删除、查看仓库信息，甚至设置可见性。
- PR 与 Issue 的深度交互：直接在终端中创建 PR、查看文件差异、请求审查以及合并代码。
- CI/CD 的掌控：查看 GitHub Actions 的运行日志、重新运行失败的工作流，甚至手动触发事件。
- 安全的身份验证：支持基于浏览器的 OAuth 流程，也支持 SSH 密钥和 Token，安全且便捷。
- 可扩展性：支持自定义扩展和别名，你可以根据自己的习惯定制专属的命令。
安装与配置指南
工欲善其事，必先利其器。让我们开始在不同平台上安装 GitHub CLI。
在 Windows 上安装
Windows 用户非常幸运，因为系统自带了名为 winget 的包管理器，这使得安装过程变得异常简单。打开 PowerShell 或 Windows Terminal，输入以下命令：
# 使用 winget 包管理器安装 GitHub CLI
winget install --id GitHub.cli
命令解析：
winget install：调用 Windows 包管理器进行软件安装。--id GitHub.cli：指定我们要安装的软件的唯一标识符。这里指向的是 GitHub CLI 的官方包。
安装完成后，建议重启终端以确保 gh 命令在全局路径中可用。
在 macOS 上安装
对于 macOS 用户，Homebrew 是最佳选择。它不仅安装主程序，还会自动处理依赖关系。打开你的终端：
# 使用 Homebrew 安装
brew install gh
安装后，你应该会看到安装成功的提示。如果遇到权限问题，请确保你的用户拥有对 INLINECODEb2649dbd 的写权限（在使用 M1/M2 芯片的 Mac 上则是 INLINECODEeeb61d1b）。
在 Linux 上安装
在 Linux 环境中，我们通常使用系统自带的包管理器。以下是基于 Ubuntu/Debian 系统的安装示例（如果你是 Fedora 或 Arch 用户，可以使用 INLINECODE0411081c 或 INLINECODE3d400621）：
# 更新软件源并安装
sudo apt update
sudo apt install gh
注意：在某些 Linux 发行版中，官方仓库里的 INLINECODEe12912ac 版本可能不是最新的。如果你需要最新功能，可以从 GitHub 官方发布的 Release 页面下载 INLINECODE9c77a613 或 .rpm 文件进行安装。
身份验证：连接你的账户
安装完成后，我们需要将 GitHub CLI 与我们的 GitHub 账户关联。这是一个一次性的过程，但却至关重要。
开始认证流程
请在终端中运行以下命令：
gh auth login
运行后，你会看到一个交互式的问答界面。让我们一步步来看如何操作（这也是新手最容易卡住的地方）：
- 选择账户类型：通常我们选择 INLINECODEd6b8693a（如果是企业版用户，请选择 INLINECODE8a274762）。
- 选择认证协议：这里强烈推荐使用
Login with a web browser（使用网页浏览器登录）。这是最安全、最现代的方式。 - 生成一次性代码：终端会显示一个八位数的验证码，并提示你按
Enter键打开浏览器。 - 浏览器授权：在浏览器中，粘贴该验证码并授权 GitHub CLI 应用访问你的账户。
- 完成配置：回到终端，系统可能会询问你是否要上传 SSH 密钥或配置 Git 凭据助手。对于初学者，一路按
Enter选择默认值通常是最安全的做法。
验证连接状态
为了确保一切正常，我们可以运行一个简单的检查命令：
# 查看当前的认证状态和登录用户
gh auth status
如果看到类似 INLINECODE91aebcc5 的输出，并且带有绿色的 INLINECODE9b15530f 符号，那么恭喜你，你已经成功连接上了！
掌握核心命令结构
GitHub CLI 的设计哲学非常直观：gh [flags]。这种层级结构让我们很容易通过命令联想功能。
- Command（主命令）：代表功能的大类，如 INLINECODEa75bb239（仓库）、INLINECODEf88dccea（议题）、INLINECODE09a0bb10（拉取请求）、INLINECODE7bdfecac（发布）等。
- Subcommand（子命令）：代表具体的动作，如 INLINECODE97531a92（创建）、INLINECODE9d810704（列表）、INLINECODE80bba476（查看）、INLINECODE0f500b9f（删除）。
- Flags（标志/参数）：用于传递具体的数据，如 INLINECODE81679f08、INLINECODEe482d7f6、
--assignee。
获取帮助
记不住命令怎么办？不要担心，CLI 自带了完善的帮助系统。
# 查看全局帮助
g --help
# 查看特定命令的帮助（例如 pr）
gh pr --help
实战演练：仓库管理
让我们把理论转化为实践。在日常开发中，创建仓库是第一步。过去，我们要去网页上点击“New Repository”，现在，我们可以在终端里瞬间完成。
创建新仓库
假设我们要初始化一个名为 my-awesome-project 的新项目。
# 创建一个私有仓库，并添加描述
gh repo create my-awesome-project --public --description "我的一个很棒的项目" --source=. --remote=origin --push
代码详解：
- INLINECODE6ccaf760：设置为公开仓库（默认是私有，可用 INLINECODE4e8863b6）。
--description：给仓库添加一段简短的描述。--source=.：指定当前目录作为仓库的源代码。- INLINECODE28fd01c1：自动将远程仓库添加为 Git 的 INLINECODEa789993a 远程源。
--push：直接将当前的本地提交推送到新创建的 GitHub 仓库。
克隆仓库
克隆操作比传统的 git clone 更智能。它不仅下载代码，还会自动配置远程仓库，甚至将你在本地配置的 forks 设置为上游仓库。
# 克隆一个仓库到当前目录
gh repo clone cli/cli
这里 cli/cli 是“所有者/仓库名”的格式。如果你不指定目录名，它会在当前文件夹下创建一个同名目录。
查看仓库详情
如果你想知道仓库的星标数、Issue 数或者最新的 Release 版本，不用去翻网页。
# 查看当前目录对应的仓库信息
ggh repo view
或者查看远程的特定仓库：
gh repo view facebook/react
高级应用：管理 Pull Requests 和 Issues
这是 GitHub CLI 最强大的功能之一。我们经常在提交代码后需要创建 PR，或者在审查代码时需要查看 Diff。
创建 Pull Request
假设你刚刚完成了一个功能的开发并推送到远程分支。创建 PR 从未如此简单：
# 基于当前分支创建 PR
gh pr create --title "新增了用户登录功能" --body "这个 PR 解决了 #123 号 Issue，实现了 JWT 认证。"
实用技巧：如果你觉得在命令行里写长正文很麻烦，可以省略 --body 参数。CLI 会打开你默认的编辑器（如 Vim 或 VS Code），让你在里面舒适地撰写 PR 描述。
查看 PR 列表
我们也可以快速浏览当前仓库的所有 Pull Requests：
# 列出所有的 PR
gh pr list
# 只列出我创建的且状态为 Open 的 PR
gh pr list --author "@me" --state open
这会输出一个清晰的表格，包含 PR 的编号、标题、状态和作者。
在终端中查看 PR Diff
这是一个非常酷的功能。你不需要去网页上点“Files changed”。
# 查看特定 PR 的代码变更
ggh pr view 45 --comments
这里的 INLINECODEa50a52e2 是 PR 的编号。加上 INLINECODE1625c0f9 标志，你甚至可以在终端里直接看到代码审查的评论。
管理 Issues
创建 Issue 的逻辑与 PR 类似。我们可以快速记录一个 Bug 或功能需求。
# 创建一个紧急 Bug
gh issue create --title "登录页面在移动端无法加载" --body "复现步骤：..." --label "bug,high-priority"
自动化工作流：GitHub Actions
作为现代开发者，我们离不开 CI/CD。GitHub CLI 允许我们直接在终端与 Actions 进行交互。
查看运行状态
想知道你刚才推送的代码是否通过了测试？
# 查看最近的工作流运行记录
gh run list
# 查看特定运行的详细日志（使用 run list 中的 ID）
gh run view 45 --log
重试失败的工作流
有时 CI 失败可能是因为网络波动或测试环境的小问题。与其去网页上点击“Re-run all jobs”，不如直接在终端重试：
# 重新运行失败的工作流
ggh run rerun 45
这个命令在调试 CI 配置时非常实用，可以极大地节省时间。
性能优化与最佳实践
为了让我们在使用 GitHub CLI 时更加高效，这里有一些进阶的建议。
1. 配置别名
如果你经常输入一些很长的命令，可以配置 Shell 别名（在你的 INLINECODE0db86392 或 INLINECODE832309e0 中）：
# 例如：将 gh pr list 缩短为 gh prls
alias ghprls=‘gh pr list‘
2. 使用脚本自动化
我们可以编写简单的 Bash 脚本来处理复杂的工作流。比如，一个“初始化新项目并推送到 GitHub”的一键脚本：
#!/bin/bash
REPO_NAME=$1
git init
git add .
git commit -m "Initial commit"
gh repo create $REPO_NAME --public --source=. --remote=origin --push
echo "仓库 $REPO_NAME 已创建并推送完成！"
3. 优化输出格式
GitHub CLI 默认输出比较友好的表格格式，但在脚本中处理时，我们需要 JSON 格式。
# 以 JSON 格式输出 Issue 列表，方便其他程序解析
ggh issue list --json title,state,number
4. 常见错误与解决
- 错误：
gh: authentication failed。
– 解决：你的 Token 可能过期了。运行 INLINECODE41480350 或 INLINECODE9ac0952a 重新登录。
- 错误：
could not find a remote named origin。
– 解决：确保你的 Git 仓库已经连接了远程分支，或者使用 --repo 参数显式指定仓库名。
结语
通过这篇文章，我们全面探索了 GitHub CLI 的强大功能。从基础的定义、安装，到核心的仓库管理、Issue 处理，再到高级的 Actions 交互和自动化脚本。
掌握 GitHub CLI 不仅仅是多学了一个命令工具，更是一种开发思维的转变——它代表着对“终端优先”工作流的追求。当我们能够用指尖的键盘掌控整个开发流程时，我们就真正成为了代码的主人。
下一步行动建议：
- 试着在你的下一个小项目中，完全脱离网页版 GitHub 界面，仅使用 CLI 完成所有操作。
- 探索
gh help中的扩展功能，看看是否有适合你团队的插件。 - 将你最常用的重复性操作编写成一个简单的 Shell 脚本。
希望这篇文章能帮助你更高效地使用 GitHub。如果你在探索过程中有任何心得或遇到棘手的问题，不妨自己写一个关于 GitHub CLI 的博客来记录它。Happy Coding！