gh CLI（GitHub CLI）安装教程（Github Command Line）

文章目录gh CLI 在 Linux 下安装指南什么是 gh CLI为什么使用 gh CLI安装前准备Ubuntu / Debian 安装1. 更新软件包2. 安装依赖3. 添加 GitHub CLI GPG Key4. 添加软件源5. 安装 gh6. 验证安装Fedora 安装Arch Linux 安装openSUSE 安装Snap 安装使用 Homebrew 安装登录 GitHub常用命令查看认证状态登出创建仓库克隆仓库创建 Issue查看 Issue创建 Pull Request查看 Pull Request查看 Workflow查看 Workflow 日志在 WSL2 中使用 gh CLI常见问题gh: command not found如何升级 gh客观评价优势局限性适用场景gh CLI 在 Linux 下安装指南什么是 gh CLIghGitHub CLI是 GitHub 官方推出的命令行工具用于在终端中管理 GitHub 资源例如创建和管理仓库提交 Pull Request查看和处理 Issues管理 Releases认证 GitHub 账户与 GitHub Actions 集成对于习惯使用终端开发的工程师来说gh可以显著减少在浏览器和终端之间切换的频率。GitHub CLI 官方网站为什么使用 gh CLI传统工作流修改代码 ↓ git push ↓ 打开浏览器 ↓ 创建 Pull Request ↓ 填写标题和描述使用 gh CLIgitpush ghprcreate整个流程可以直接在终端完成。例如gh repo create gh issue create ghprcreate gh release create安装前准备首先确认系统版本cat/etc/os-release输出示例NAMEUbuntu VERSION24.04 LTS或者NAMEDebian GNU/Linux VERSION12 (bookworm)不同发行版安装方式略有差异。Ubuntu / Debian 安装GitHub 官方推荐通过 APT 仓库安装。1. 更新软件包sudoaptupdate2. 安装依赖sudoaptinstallcurl-y3. 添加 GitHub CLI GPG Keycurl-fsSLhttps://cli.github.com/packages/githubcli-archive-keyring.gpg\|sudoddof/usr/share/keyrings/githubcli-archive-keyring.gpg设置权限sudochmodgor /usr/share/keyrings/githubcli-archive-keyring.gpg4. 添加软件源echodeb [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/null5. 安装 ghsudoaptupdatesudoaptinstallgh-y6. 验证安装gh--version输出类似gh version 2.82.0 https://github.com/cli/cli/releases/latestFedora 安装使用 DNFsudodnfinstalldnf-command(config-manager)添加仓库sudodnf config-manager addrepo --from-repofilehttps://cli.github.com/packages/rpm/gh-cli.repo安装sudodnfinstallgh-y验证gh--versionArch Linux 安装Arch Linux 官方仓库已提供 gh。安装sudopacman-Sgithub-cli验证gh--versionopenSUSE 安装安装sudozypperinstallgh如果仓库中没有对应版本可参考官方 RPM 仓库安装方式。Snap 安装对于支持 Snap 的发行版sudosnapinstallgh优点安装简单自动更新缺点启动速度略慢与系统包管理器独立使用 Homebrew 安装如果 Linux 环境已经安装 Homebrewbrewinstallgh验证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创建 Issuegh issue create查看 Issuegh issue list创建 Pull Requestghprcreate查看 Pull Requestghprlist查看 Workflowgh 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 中。如何升级 ghAPT 安装sudoaptupdatesudoaptupgrade ghHomebrew 安装brew upgrade ghSnap 安装sudosnap refresh gh客观评价优势GitHub 官方维护与 GitHub 功能高度集成支持 PR、Issue、Actions 等常见工作流自动化脚本友好学习成本较低局限性仅适用于 GitHub 生态某些高级功能仍需访问 Web 页面对新手而言图形界面仍然更直观适用场景非常适合后端开发DevOps开源维护者AI Agent 开发Claude Code / Codex 工作流如果你已经习惯在终端中使用 Git那么安装gh CLI基本属于高收益、低成本的工具升级。尤其是在 WSL2 开发环境中它已经成为许多开发者的标准工具链之一。