3 条命令搞定 PR 审查与合并：GitHub CLI 终端上手指南

3 条命令搞定 PR 审查与合并：GitHub CLI 终端上手指南

【免费下载链接】cliGitHub’s official command line tool项目地址: https://gitcode.com/GitHub_Trending/cli/cli

GitHub CLI（命令简称gh）是 GitHub 官方出品的命令行工具，面向天天和 git 打交道的开发者：提 PR、建 issue、看 CI 状态、管发布，都在终端里完成，不用再打开浏览器。

🧭 一分钟了解 GitHub CLI

GitHub CLI 的定位可以用一句话说清：把 GitHub 网站上的协作操作搬进终端。它是一个独立工具，不会改动你习惯的 git 用法——git 照常写代码、提交，gh负责那些原来要"切到浏览器点几下"的事，比如看 PR 状态、评论、合并。输出是紧凑的表格加颜色标识，一眼能扫完全仓情况。

📦 安装与首次配置：一条命令登录

最常见的装法是用系统包管理器，下面以 macOS 为例，Ubuntu、Fedora 等换成对应包管理器即可，Windows 用 winget 也是一行：

brew install gh gh auth login

装完后只需登录一次：终端会引导你选账号和授权方式，走浏览器点一下确认即可，凭据存在本地钥匙串里，之后的命令都不用再输密码。如果你是在 CI 环境里用，可以跳过登录，直接设GH_TOKEN环境变量。各平台的详细安装步骤见官方文档：install_linux.md。

⌨️ 4 个高频场景，5 条命令覆盖

• 看 PR 全局状态：gh pr status按"当前分支 / 我创建的 / 等我评审"分组，检查是否通过直接标在每行旁边。
• 快速建 issue：gh issue view能看详情，gh issue create则打开编辑器，写好标题正文直接提交。
• 本地分支变 PR：gh pr create自动推送当前分支并建 PR，标题、描述在编辑器里一次写完。
• 合并并清理：gh pr merge 1234一键合并，加--delete-branch顺手删掉两端分支。

gh pr status gh issue create gh pr create gh pr merge 1234 --delete-branch

🧩 进阶玩法（选读）

让输出可脚本化

gh支持--json参数输出结构化字段（可接jq这类 JSON 处理工具做过滤），比如gh pr list --json number,title，列表就能直接喂给下一个命令。

在 CI 里直接用

GitHub Actions 官方 runner 已预装gh，工作流里设好GH_TOKEN就能跑：自动打 release、给 issue 打标签、发评论，都不用额外安装。

🎯 适合谁用 / 上手建议

• 如果你的日常是评审 PR 和提交代码，先记住gh pr status、gh pr list、gh pr merge三条，就能覆盖一天的大部分操作。
• 如果你写 Shell 或维护 CI，重点试--json和GH_TOKEN，这是把gh变成自动化入口的钥匙。
• 记不住某个命令的用法，直接在终端敲gh 命令名 --help，或者翻完整手册：docs/，所有命令实现源码在 pkg/cmd/。

终端本来就是开发者的主阵地，现在连 GitHub 的协作环节也搬了进来——把点鼠标的事交给gh，把思考留给自己。

【免费下载链接】cliGitHub’s official command line tool项目地址: https://gitcode.com/GitHub_Trending/cli/cli