多平台全攻略:GitHub CLI 安装与登录,用命令行高效管理仓库与 PR

你会用到什么:GitHub CLI(gh)到底解决什么问题?

如果你经常在浏览器里反复点「仓库」「Pull Request」「Issue」「Actions」,其实很多操作都可以在终端里用更少的步骤完成。GitHub CLI(命令为 gh)相当于把常用的 GitHub 功能搬到命令行:查看仓库信息、搜索与管理 Issue、创建/审核 PR、拉取 PR 到本地测试、甚至打开网页对照等。

工具地址:https://cli.github.com/

参考链接:https://docs.github.com/en/github-cli

安装前检查:确认系统里是否已有 gh

先在终端/命令提示符里执行一次:如果能输出版本号,就说明已经安装。

gh --version

Windows 安装:winget 一条命令搞定

Windows 10/11 推荐直接用 winget 安装(系统自带或通过 Microsoft Store 更新)。管理员权限不是必须,但如果你遇到权限提示,请按系统要求操作。

winget install --id GitHub.cli

安装完成后重新打开终端,再次确认:

gh --version

macOS 安装:Homebrew 最稳

macOS 用户通常用 Homebrew 管理命令行工具。没有 Homebrew 也可以去官网下载包,但本文以 Homebrew 为例(更方便后续升级)。

brew install gh

升级时:

brew upgrade gh

Linux 安装:优先使用发行版仓库或官方说明

不同发行版的包管理器不一样,建议优先参考官方安装页,选择与你系统匹配的方式。这里给一个通用思路:先在包管理器里搜索,再安装。

gh --help

如果系统仓库版本偏旧,可以按官方文档使用官方源/二进制包(遵循你所在环境的安全策略,不要随意运行不明脚本)。

安全登录:用 gh auth login 完成授权(推荐 HTTPS 模式)

登录的关键点是「授权」,而不是“拿到密码”。gh auth login 会引导你选择 GitHub.com / 企业版地址、选择 HTTPS 或 SSH、以及是否把 Token 写入系统 Keychain/凭据管理器。

gh auth login

完成后你可以检查当前登录状态:

gh auth status

提示:如果你在公司设备上,建议开启系统层的凭据存储(Keychain/Windows Credential Manager),避免把 Token 明文写在配置文件里。

高频命令清单:日常协作最省时间的 8 个用法

1)快速查看自己相关的 PR(需要时可加筛选条件):

gh pr list

2)创建 PR(自动打开交互式引导,适合新手):

gh pr create

3)在本地检出某个 PR 进行测试(不用手动找分支名):

gh pr checkout 123

4)查看 PR 详情(包含 checks、评论等):

gh pr view 123

5)把 PR 在浏览器里打开对照(需要图形界面时很方便):

gh pr view 123 --web

6)列出 Issue / 创建 Issue:

gh issue list

gh issue create

7)查看当前仓库信息(确认远端、默认分支等):

gh repo view

8)把仓库直接克隆到本地(支持 owner/repo 简写):

gh repo clone owner/repo

常见坑与排查:三分钟自救

1)命令找不到:多数是 PATH 没刷新。Windows 重新打开终端;macOS/Linux 重新打开 shell 或执行 hash -r。

2)登录成功但没有权限:可能是授权范围不够或登录了错误账号。用 gh auth status 确认当前账号;必要时先登出再登录。

3)企业 GitHub:如果你使用 GitHub Enterprise Server,需要在登录时选择对应 Host,或按文档配置(不要把内部地址写错)。

一套推荐工作流:把“开网页 + 点来点去”变成 3 步

把下面这个组合当作固定动作:先列出待处理 PR,再打开详情,最后需要时检出到本地测试。

gh pr list

gh pr view 123

gh pr checkout 123

当你熟悉后,可以把常用命令做成终端 alias 或脚本(注意公司环境的安全规范)。

用户评论 (0)

登录后参与讨论

立即登录 注册账号

暂无评论,快来抢沙发吧~

操作成功