如何把 PR 管理搬进终端：GitHub CLI 命令行工具完整指南

如何把 PR 管理搬进终端GitHub CLI 命令行工具完整指南【免费下载链接】cliGitHub’s official command line tool项目地址: https://gitcode.com/GitHub_Trending/cli/cli你有没有算过处理一条 PR 要在浏览器和终端之间切换多少次填标题、复制分支名、看 CI 状态、合并——每一步都要开网页。GitHub CLIgh就是来解决这个问题的它把拉取请求、Issue、仓库操作都放进了终端让你在不离开代码目录的情况下完成整个 GitHub 工作流。它是 GitHub 官方出品的命令行工具覆盖 macOS、Windows、Linux支持 GitHub.com、GitHub Enterprise Cloud 和 Enterprise Server 2.20。安装 gh 并完成首次登录一条最短路径先按平台装好工具再登录一次账号之后所有命令都可用。# WindowsWinGet 官方渠道 winget install --id GitHub.cli --source winget # macOSHomebrew brew install gh # LinuxDebian/Ubuntu 官方仓库 sudo apt install ghWindows 安装会修改 PATH需要开一个新窗口才能生效。装完后登录gh auth login # 按提示选择主机、认证方式并授权如果走的是浏览器认证嫌麻烦也可以直接用 tokengh auth login --with-token mytoken.txt。登录后跑一下gh auth status确认各主机状态都是 authenticated 就可以开工了。需要自建账号或配置多账号切换可以看 docs/multiple-accounts.md。实战场景一快速查看我手上有哪些 PR当你每天开工想知道自己负责的分支走到哪一步了就用gh pr status。它在当前仓库下自动筛出你参与的和等待你评审的 PR不用去网页翻。gh pr status # 列出我相关的 PR 与待我评审的 PR gh pr list # 查看当前仓库所有开放 PR gh pr list --search author:me is:open # 按条件筛选想切到某条 PR 的最新状态gh pr view 123能直接打印出分支、状态和描述比打开网页快得多。实战场景二一键切到某条 PR 的分支当同事发了一条 PR 要你看代码最烦的是手动敲git fetch再拼出origin/分支名。用gh pr checkout一步到位gh pr checkout 123 # 拉取并切换到 PR #123 的分支 gh pr checkout # 不带参数时交互式选择要 checkout 的 PR它会自动创建本地跟踪分支切完直接能改代码、跑测试。改完之后git push会直接推回 PR不需要关心远端分支叫什么。实战场景三从建 PR 到合并全流程当你写完功能分支准备提交流程用gh pr create起步。它会交互式地问你标题、描述、目标分支也可以全部用参数跳过gh pr create --title feat: 新增登录接口 --body 支持 token 登录 # 直接创建 PR gh pr checks 123 # 等 CI 跑完只看通过/失败状态 gh pr merge 123 --squash # 检查全绿后合并支持 --merge/--squash/--rebase合并前如果 CI 还有红的gh pr checks会列出具体哪个 job 失败点开对应链接就能定位不用在 Actions 页面里翻。实战场景四不切窗口处理 Issue当你被分到一条 Issue 需要先了解上下文用gh issue viewgh issue view 456 # 查看标题、标签、正文和评论 gh issue list --label bug --state open # 按标签过滤 gh issue comment 456 --body 已定位到原因修复中 # 直接回复gh issue view的输出会带状态、创建人、时间和评论数如上图看完整条时间线不用再开浏览器。要建 issue 同理gh issue create --title ... --body ...一条命令搞定。进阶用法别名、JSON 输出与脚本化这三个技巧能让gh从命令行工具升级成你的开发基础设施。自定义别名把常用长命令缩写。gh alias set co pr checkout # 之后 gh co 123 即可 gh alias set st status # 快速查看我相关的 PRJSON 输出几乎所有查询命令都支持--json配合--jq提取字段不用装额外工具。gh pr list --json number,title,state --jq .[] | select(.stateOPEN) | .number机器可读输出管道里输出会自动降级为无格式的纯文本方便写脚本。如果还想调 GitHub API 本身gh api repos/owner/repo会以当前登录身份直接请求 REST 接口省去手动带 token。常见坑与排错坑 1提示 You are not logged into any GitHub hosts说明还没登录或登录过期。跑gh auth login重新认证如果之前配过GITHUB_TOKEN环境变量它优先级高于本地登录态先检查是否冲突。多账号环境下用gh auth switch切换。坑 2命令报 not a git repository 或 could not resolve to a repositorygh多数命令依赖当前目录的 git 仓库来推断目标仓库。要么先cd进仓库目录要么显式指定gh pr list -R owner/repo # 在任何目录下指定目标仓库另外注意 Windows 下安装后要开新终端窗口不是新标签页否则 PATH 没生效命令会找不到。延伸学习命令语法约定必填参数、[]可选参数等见 docs/command-line-syntax.md各平台安装细节在 docs/install_linux.md 等文件gh help command查看任意命令的完整参数说明gh help列出全部命令PR 相关命令源码在 pkg/cmd/pr/Issue 在 pkg/cmd/issue/想理解某个命令行为可以顺藤摸瓜gh与老工具 hub 的设计差异说明在 docs/gh-vs-hub.md下一步现在打开你常用的仓库目录跑一条gh pr status。如果它打印出了你的 PR 列表恭喜浏览器标签页可以少开一半了。【免费下载链接】cliGitHub’s official command line tool项目地址: https://gitcode.com/GitHub_Trending/cli/cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考