在Linux和BSD系统上安装GitHub CLI工具(gh)的完整指南

在Linux和BSD系统上安装GitHub CLI工具(gh)的完整指南

cli cli/cli: cli (GitHub CLI) 是GitHub官方提供的命令行工具，允许开发者在终端中更加方便地与GitHub进行交互，执行如创建pull request、管理仓库、查看议题等操作。 项目地址: https://gitcode.com/gh_mirrors/cli/cli

GitHub CLI(简称gh)是GitHub官方提供的命令行工具，它允许开发者直接在终端中与GitHub进行交互。本文将详细介绍在各种Linux发行版和BSD系统上安装gh的多种方法。

官方支持的安装方式

基于Debian的系统安装(Ubuntu/Debian/Raspberry Pi OS)

对于Debian、Ubuntu及其衍生系统，可以通过添加官方软件源来安装：

# 安装依赖并添加GPG密钥
(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y)) \
    && sudo mkdir -p -m 755 /etc/apt/keyrings \
    && out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
    && cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
    && sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
    && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
    && sudo apt update \
    && sudo apt install gh -y

更新gh到最新版本：

sudo apt update && sudo apt install gh

注意：如果遇到GPG签名错误，可能需要手动更新密钥环。

基于RPM的系统安装(Fedora/CentOS/RHEL)

对于使用DNF包管理器的系统，有两种安装方式：

DNF5安装方式

sudo dnf install dnf5-plugins
sudo dnf config-manager addrepo --from-repofile=https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install gh --repo gh-cli

DNF4安装方式

sudo dnf install 'dnf-command(config-manager)'
sudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install gh --repo gh-cli

Amazon Linux 2安装

type -p yum-config-manager >/dev/null || sudo yum install yum-utils
sudo yum-config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo
sudo yum install gh

openSUSE/SUSE Linux安装

sudo zypper addrepo https://cli.github.com/packages/rpm/gh-cli.repo
sudo zypper ref
sudo zypper install gh

手动安装方式

如果您的系统不在上述支持列表中，或者您需要特定版本的gh，可以选择手动安装：

1. 下载对应平台的预编译二进制文件
2. 解压下载的文件
3. 将可执行文件移动到系统PATH路径中

社区维护的安装方式

以下安装方式由社区维护，更新可能滞后于官方版本：

Arch Linux

sudo pacman -S github-cli

FreeBSD

pkg install gh

Nix/NixOS

nix-env -iA nixos.gh

Alpine Linux

apk add github-cli

Void Linux

sudo xbps-install github-cli

安装后的验证

安装完成后，可以通过以下命令验证安装是否成功：

gh --version

如果安装正确，这将显示当前安装的gh版本信息。

注意事项

1. 建议优先使用官方提供的安装方式，以获得最新的功能和安全性更新
2. 社区维护的包可能会有版本滞后问题
3. 不推荐使用Snap方式安装gh，因为存在已知的运行时问题
4. 安装过程中如遇到GPG签名错误，可能需要手动更新密钥

通过本文介绍的各种方法，您应该能够在大多数Linux和BSD系统上成功安装GitHub CLI工具。安装完成后，您就可以在终端中高效地与GitHub进行交互，提升您的工作效率。

cli cli/cli: cli (GitHub CLI) 是GitHub官方提供的命令行工具，允许开发者在终端中更加方便地与GitHub进行交互，执行如创建pull request、管理仓库、查看议题等操作。 项目地址: https://gitcode.com/gh_mirrors/cli/cli