如果你经常在 GitHub 上做这些事:克隆/创建仓库、提 Issue、开 PR、看审查意见、切换账号、在多台设备同步配置,那么 GitHub CLI(命令:gh)会比浏览器更快、更可复制。
GitHub CLI 官网:https://cli.github.com/
开源仓库与文档:https://github.com/cli/cli
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
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
例如把“列出我创建的 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,形成自己的工作流。