GitHub CLI 安装指南

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

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

GitHub CLI 的优势

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

1. Windows 平台

使用安装包

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

使用包管理工具

通过 Scoop 安装

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

bash 复制代码

scoop install gh

通过 Chocolatey 安装

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

bash 复制代码

choco install gh

验证安装

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

bash 复制代码

gh --version

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

2. macOS 平台

使用 Homebrew 安装

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

bash 复制代码

brew install gh

验证安装

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

bash 复制代码

gh --version

3. Linux 平台

使用官方包管理器

Ubuntu/Debian

更新包管理器：

bash 复制代码

sudo apt update

安装 GitHub CLI：

bash 复制代码

sudo apt install gh

Fedora

更新包管理器：

bash 复制代码

sudo dnf check-update

安装 GitHub CLI：

bash 复制代码

sudo dnf install gh

CentOS/RHEL

启用 EPEL 仓库：

bash 复制代码

sudo yum install epel-release

安装 GitHub CLI：

bash 复制代码

sudo yum install gh

使用二进制文件安装

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

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

bash 复制代码

tar -xvzf gh_*_linux_amd64.tar.gz

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

bash 复制代码

sudo cp gh /usr/local/bin

验证安装：

bash 复制代码

gh --version

4. 配置和登录

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

登录 GitHub CLI

在终端中运行以下命令：

bash 复制代码

gh auth login

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

验证登录状态

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

bash 复制代码

gh auth status

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

Logged in to github.com as <your_username>

总结

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