GitHub CLI(gh)效率指南:安装、登录与 10 个常用工作流

这篇教程适合谁

如果你经常在 GitHub 上做这些事:克隆/创建仓库、提 Issue、开 PR、看审查意见、切换账号、在多台设备同步配置,那么 GitHub CLI(命令:gh)会比浏览器更快、更可复制。

工具地址与参考链接

GitHub CLI 官网:https://cli.github.com/

开源仓库与文档:https://github.com/cli/cli

安装(macOS / Windows / Linux)

macOS(Homebrew)

安装:

brew install gh

验证版本:

gh --version

Windows(包管理器安装后验证)

安装完成后在 PowerShell 或 Windows Terminal 执行:

gh --version

Linux

不同发行版方式不同,建议按官网文档选择对应发行版与包源。安装后同样验证:

gh --version

登录与权限:两分钟搞定认证

首次使用建议走交互式登录,会自动打开浏览器完成授权:

gh auth login

认证成功后检查当前账号与 Token 状态:

gh auth status

多账号切换:

gh auth switch

10 个高频工作流:把网页操作变成可复制步骤

1) 快速克隆仓库

gh repo clone OWNER/REPO

2) 在当前目录创建新仓库并推送

gh repo create

3) 查看 PR 列表

gh pr list

4) 从当前分支创建 PR

gh pr create

5) 打开 PR 网页详情

gh pr view --web

6) 检出某个 PR 到本地

gh pr checkout 123

7) 合并 PR(按提示选择 merge/squash/re )

gh pr merge 123

8) 创建 Issue

gh issue create

9) 搜索 Issue/PR

gh search issues "keyword"

10) 查看通知(适合审查队列)

gh api notifications

提效设置:alias 与习惯配置

把常用命令做成 alias

例如把“列出我创建的 PR”做成短命令:

gh alias set prme "pr list --author @me"

以后只需:

gh prme

统一编辑器(可选)

如果你希望创建 PR/Issue 时用指定编辑器,可以配置环境变量(不同系统设置方式不同):

export GIT_EDITOR=nano

常见问题排查(合规版)

1) 登录后仍提示权限不足

先确认当前账号:

gh auth status

再重新登录刷新授权:

gh auth login

2) gh 命令找不到

一般是 PATH 未生效或终端未重启。重开终端后再验证:

gh --version

小结:最小上手路径

1) 安装并确认版本:gh --version

2) 登录:gh auth login

3) 先掌握 3 个命令:gh repo clone、gh pr create、gh pr view --web

4) 再把高频动作做成 alias,形成自己的工作流。

用户评论 (0)

登录后参与讨论

立即登录 注册账号

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

操作成功