GitHub CLI 跨平台安装与配置指南

GitHub CLI 跨平台安装与配置指南

GitHub CLI 是 GitHub 官方提供的命令行工具，可以帮助开发者方便地与 GitHub 平台进行交互，例如克隆仓库、提交代码、创建 Pull Request 等。

相比传统的 HTTPS 下载和操作，GitHub CLI 提供了以下显著的优势和特殊功能：

GitHub CLI 的优势

1. 快速交互 GitHub 功能：
   • 不仅支持克隆仓库，还可以直接通过命令行创建 Issue、合并 Pull Request、管理 GitHub Actions 等操作。
   • 节省了在 GitHub 网站和本地终端之间切换的时间。
2. 增强的身份验证支持：
   • 提供更安全的登录方式，支持 OAuth 和 SSH，不再需要手动输入用户名和密码。
   • 支持 Personal Access Token（PAT）和浏览器授权。
3. 丰富的命令功能：
   • 使用 gh 可以管理仓库的各个方面，例如：
     • gh repo clone：克隆仓库。
     • gh issue create：创建 Issue。
     • gh pr create：创建 Pull Request。
     • gh run watch：监控 GitHub Actions 的运行状态。
4. 跨平台支持：
   • 支持 Windows、macOS 和多种 Linux 发行版。
   • 二进制安装简单快捷，无需额外依赖。
5. 命令行友好：
   • 提供交互式命令提示，帮助用户快速学习和掌握操作。
   • 支持 Shell 脚本集成，方便自动化工作流的构建。

---

Windows 平台

使用安装包

1. 打开 GitHub CLI 官方下载页面：GitHub CLI Releases。
2. 找到最新版本的安装包（以 .msi 文件结尾）。
3. 下载适合你系统架构的安装包（如 gh_2.0.0_windows_amd64.msi）。
4. 双击安装包并按照提示完成安装。

使用包管理工具

通过 Scoop 安装

如果已经安装了 Scoop，可以运行以下命令安装 GitHub CLI：

scoop install gh

通过 Chocolatey 安装

如果已经安装了 Chocolatey，可以运行以下命令安装 GitHub CLI：

choco install gh

验证安装

安装完成后，在终端中运行以下命令验证是否安装成功：

gh --version

如果输出 GitHub CLI 的版本号，则说明安装成功。

---

macOS 平台

使用 Homebrew 安装

1. 确保已安装 Homebrew（如果未安装，可以通过 Homebrew 官网 获取安装方法）。
2. 在终端中运行以下命令安装 GitHub CLI：

brew install gh

验证安装

安装完成后，运行以下命令验证是否安装成功：

gh --version

---

Linux 平台

使用官方包管理器

Ubuntu/Debian

1. 更新包管理器：

sudo apt update

2. 安装 GitHub CLI：

sudo apt install gh

Fedora

1. 更新包管理器：

sudo dnf check-update

2. 安装 GitHub CLI：

sudo dnf install gh

CentOS/RHEL

1. 启用 EPEL 仓库：

sudo yum install epel-release

2. 安装 GitHub CLI：

sudo yum install gh

使用二进制文件安装

如果你的发行版没有提供 GitHub CLI，可以从 GitHub CLI Releases 页面下载适合的二进制文件，并手动安装。

1. 下载适合系统的二进制文件（例如 .tar.gz 文件）。
2. 解压文件：

tar -xvzf gh_*_linux_amd64.tar.gz

3. 将二进制文件复制到 /usr/local/bin 目录：

sudo cp gh /usr/local/bin

4. 验证安装：

gh --version

---

配置和登录

安装完成后，需要进行基本的配置和登录操作。

登录 GitHub CLI

1. 在终端中运行以下命令：

gh auth login

2. 根据提示选择：
   • GitHub 平台：选择 GitHub.com 或企业 GitHub 实例。
   • 协议：选择 HTTPS（推荐）。
   • 登录方式：建议选择 Login with a web browser。
3. 打开浏览器，访问提供的 URL，并输入终端显示的授权代码完成登录。

验证登录状态

运行以下命令验证是否登录成功：

gh auth status

如果成功，会显示类似以下内容：

Logged in to github.com as <your_username>

---

总结

GitHub CLI 是一个强大的工具，提供了比传统 HTTPS 操作更高效、更安全的交互方式。它集成了 GitHub 平台的多种功能，适合需要频繁管理仓库和工作流的开发者。