GitHub CLI(gh)提效全攻略:安装、登录、PR/Issue 常用命令与工作流

GitHub 官方提供的 GitHub CLI(命令名:gh),可以把很多日常操作(拉取仓库、创建 PR、审核代码、管理 Issue、看 CI 状态等)从浏览器搬到终端里完成。它的优势不是“更酷”,而是更快、可脚本化、少点鼠标

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

一、安装:Windows / macOS / Linux 三套常用方案

macOS(Homebrew)

brew install gh

Windows(winget)

winget install --id GitHub.cli

Ubuntu / Debian(apt)

不同发行版的仓库配置略有差异,建议直接按官方文档步骤走:https://github.com/cli/cli#installation

二、登录与认证:选对方式,后面少踩坑

第一次使用建议先登录。gh 支持浏览器授权,也支持粘贴 Token。大多数个人账号用浏览器授权最省心。

gh auth login

建议选择 HTTPS 作为 Git 协议(除非你已经把 SSH 多账号配置得很熟)。登录完成后可自检:

gh auth status

如果你在公司环境需要走代理,优先把代理配置在系统或终端里(例如设置环境变量),再重新执行登录。

三、仓库相关:克隆、创建、查看信息

克隆仓库(会自动选择你已登录账号的最佳方式):

gh repo clone owner/repo

创建仓库(支持交互式配置可见性、是否初始化 README 等):

gh repo create

在终端快速打开项目主页

gh repo view --web

四、PR 工作流:从创建到审核,一条龙

创建 PR(推荐交互式,能选 分支、填写标题与描述):

gh pr create

查看 PR 列表

gh pr list

检出某个 PR 到本地分支(适合快速复现问题或本地跑测试):

gh pr checkout 123

在浏览器打开当前 PR

gh pr view --web

看 CI 状态与检查项(对“为什么不能合并”很有用):

gh pr checks

五、Issue 管理:快速建单、筛选与关闭

创建 Issue

gh issue create

列出 Issue(可按指派人、标签等过滤):

gh issue list

查看某个 Issue 详情

gh issue view 456

六、常见问题与避坑:权限、账号与网络

1)提示权限不足 / 需要 SSO:一些组织开启了 SSO 或更严格的权限策略。此时请在组织页面完成 SSO 授权,或让管理员为你开通需要的权限范围。

2)多账号切换:gh 支持多个认证上下文,建议把不同账号分别登录后按需切换,避免把个人 Token 用在公司仓库上。

3)网络问题导致登录失败:优先检查代理与 DNS;必要时用浏览器授权重试。确认能正常访问 https://github.com/ 后再操作。

七、一个最小“提效套路”:把高频动作固化成习惯

如果你每天都在做“看 PR 列表 → 打开 PR → 看检查项 → 需要时检出跑一下”,可以把这一串固定成:

gh pr list

gh pr view --web

gh pr checks

配合终端的历史命令与别名(alias),你会明显减少在网页里来回点的时间。

用户评论 (0)

登录后参与讨论

立即登录 注册账号

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

操作成功