企业官网建设流程全解析

gh CLI 在 Linux 下安装指南

什么是 gh CLI

gh（GitHub CLI）是 GitHub 官方推出的命令行工具，用于在终端中管理 GitHub 资源，例如：

• 创建和管理仓库
• 提交 Pull Request
• 查看和处理 Issues
• 管理 Releases
• 认证 GitHub 账户
• 与 GitHub Actions 集成

对于习惯使用终端开发的工程师来说，gh可以显著减少在浏览器和终端之间切换的频率。

GitHub CLI 官方网站

为什么使用 gh CLI

传统工作流：

修改代码 ↓ git push ↓ 打开浏览器 ↓ 创建 Pull Request ↓ 填写标题和描述

使用 gh CLI：

gitpush ghprcreate

整个流程可以直接在终端完成。

例如：

gh repo create gh issue create ghprcreate gh release create

安装前准备

首先确认系统版本：

cat/etc/os-release

输出示例：

NAME="Ubuntu" VERSION="24.04 LTS"

或者：

NAME="Debian GNU/Linux" VERSION="12 (bookworm)"

不同发行版安装方式略有差异。

Ubuntu / Debian 安装

GitHub 官方推荐通过 APT 仓库安装。

1. 更新软件包

sudoaptupdate

2. 安装依赖

sudoaptinstallcurl-y

3. 添加 GitHub CLI GPG Key

curl-fsSLhttps://cli.github.com/packages/githubcli-archive-keyring.gpg\|sudoddof=/usr/share/keyrings/githubcli-archive-keyring.gpg

设置权限：

sudochmodgo+r /usr/share/keyrings/githubcli-archive-keyring.gpg

4. 添加软件源

echo"deb [arch=$(dpkg --print-architecture)\ signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] \ https://cli.github.com/packages stable main"\|sudotee/etc/apt/sources.list.d/github-cli.list>/dev/null

5. 安装 gh

sudoaptupdatesudoaptinstallgh-y

6. 验证安装

gh--version

输出类似：

gh version 2.82.0 https://github.com/cli/cli/releases/latest

Fedora 安装

使用 DNF：

sudodnfinstall'dnf-command(config-manager)'

添加仓库：

sudodnf config-manager addrepo --from-repofile=https://cli.github.com/packages/rpm/gh-cli.repo

安装：

sudodnfinstallgh-y

验证：

gh--version

Arch Linux 安装

Arch Linux 官方仓库已提供 gh。

安装：

sudopacman-Sgithub-cli

验证：

gh--version

openSUSE 安装

安装：

sudozypperinstallgh

如果仓库中没有对应版本，可参考官方 RPM 仓库安装方式。

Snap 安装

对于支持 Snap 的发行版：

sudosnapinstallgh

优点：

• 安装简单
• 自动更新

缺点：

• 启动速度略慢
• 与系统包管理器独立

使用 Homebrew 安装

如果 Linux 环境已经安装 Homebrew：

brewinstallgh

验证：

gh--version

登录 GitHub

安装完成后，需要进行认证。

执行：

gh auth login

系统会引导选择：

? What account do you want to log into? > GitHub.com

选择认证方式：

> Login with a web browser

随后会生成验证码，例如：

ABCD-1234

打开浏览器完成授权即可。

https://github.com/login/device

验证登录状态：

gh auth status

示例输出：

Logged in to github.com as your_username

常用命令

查看认证状态

gh auth status

登出

gh authlogout

创建仓库

gh repo create

克隆仓库

gh repo clone owner/repository

例如：

gh repo clone cli/cli

创建 Issue

gh issue create

查看 Issue

gh issue list

创建 Pull Request

ghprcreate

查看 Pull Request

ghprlist

查看 Workflow

gh run list

查看 Workflow 日志

gh run view

在 WSL2 中使用 gh CLI

对于 Windows + WSL2 开发环境，推荐直接在 Ubuntu 发行版中安装 gh。

典型开发环境如下：

Windows └── WSL2 Ubuntu ├── Git ├── GitHub CLI ├── Docker CLI ├── Python ├── Node.js └── Claude Code

这样可以获得：

• 原生 Linux 开发体验
• 与 Git 集成更自然
• Claude Code 可直接调用 gh 命令
• 自动化脚本无需跨系统调用

验证：

whichgh

输出类似：

/usr/bin/gh

常见问题

gh: command not found

确认安装成功：

whichgh

如果没有输出：

echo$PATH

检查安装目录是否在 PATH 中。

如何升级 gh

APT 安装：

sudoaptupdatesudoaptupgrade gh

Homebrew 安装：

brew upgrade gh

Snap 安装：

sudosnap refresh gh

客观评价

优势

• GitHub 官方维护
• 与 GitHub 功能高度集成
• 支持 PR、Issue、Actions 等常见工作流
• 自动化脚本友好
• 学习成本较低

局限性

• 仅适用于 GitHub 生态
• 某些高级功能仍需访问 Web 页面
• 对新手而言，图形界面仍然更直观

适用场景

非常适合：

• 后端开发
• DevOps
• 开源维护者
• AI Agent 开发
• Claude Code / Codex 工作流

如果你已经习惯在终端中使用 Git，那么安装gh CLI基本属于高收益、低成本的工具升级。尤其是在 WSL2 开发环境中，它已经成为许多开发者的标准工具链之一。