上游 · 理解本功能前需先掌握的（1）：
下游 · 依赖/承接本功能的（0）：
暂无下游（建议学完它再进阶）
前置依赖包含从属概念升级流程承接
边方向 = 学习顺序（A→B 表示先学 A 再学 B）
为什么需要它
心智模型
平时操作 GitHub 要在浏览器里点来点去，开 PR、查 Issue、看流水线都要切页面，很慢。GitHub CLI 把整个 GitHub 都搬进终端，一个 gh 命令搞定所有平台操作，配合 git 命令，全程不用离开命令行。
历史背景 · 它为什么诞生诞生于 2020
诞生大量开发者日常工作在终端中完成，但GitHub功能（PR/Issue/release）要到浏览器操作，频繁上下文切换打断工作流。2020-09-17 GitHub CLI 1.0 GA，把GitHub带入终端。
功能介绍
GitHub CLI（命令行工具，命令名为 gh）官方定义是 "brings pull requests, issues, GitHub Actions, and other GitHub features to your terminal"——把拉取请求、Issue、Actions 以及 GitHub 的其他功能带到你的终端里。它和 git 的分工要分清：git 管「版本控制」本身，比如提交（commit）、分支（branch）、合并（merge）；而 gh 管「GitHub 平台」，比如查看和创建 Issue、发起和审查 PR、查看 Actions 运行状态、管理仓库。两者配合使用：你先用 git 提交代码，再用 gh pr create 发起拉取请求，全程不需要打开浏览器。gh 支持几乎所有 Web 端功能，还支持 gh repo、gh issue、gh pr、gh run、gh gist 等子命令分组，安装后用 gh auth login 登录一次即可使用。
核心术语
命令行工具（Command Line Interface，CLI）终端（Terminal）认证登录（Authentication）拉取请求（Pull Request）仓库（Repository）
适用场景
- 当你想在终端里直接查看和创建 Issue 时
- 当你想在本地用命令行发起 Pull Request 而不是去网页点时
- 当你想快速查看 Actions 流水线跑得怎么样时
- 当你想查某个仓库信息或直接 clone 下来时
- 当你想用脚本批量操作 GitHub（如批量关掉过期 Issue）时
怎么操作（网页 vs 命令行 双轨）
🖱️ 网页操作 (GitHub.com)
- 访问 github.com 下载并安装 GitHub CLI 安装包
- 安装后在终端运行 gh auth login 完成网页授权登录
⌨️ 命令行 (进阶)
`gh auth login` # 登录 GitHub 账号（首次使用必做）`gh repo create my-project --public` # 创建新仓库`gh pr create --title "新增功能" --body "说明"` # 从当前分支发起 PR`gh issue list` # 列出仓库中的所有 Issue`gh run list` # 查看 Actions 运行记录
新手建议先从网页操作入手，熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。
与其他功能的关系
| 关系（前置依赖 / 包含从属 / 概念升级 / 流程承接） | 说明 |
|---|---|
| 概念升级Git 命令行基础（Git CLI Basics） | gh 命令把 GitHub 功能带到终端，与 git 命令配合 |
官方文档
小结
SUMMARY
GitHub CLI（gh）把仓库、Issue、PR、Actions 全部带进终端，与 git 各司其职，能省下大量切换浏览器的时间。下一步：安装后运行 gh auth login，然后试试 gh repo create 创建第一个仓库。