很多初学者常常把 Git 和 GitHub 混为一谈。简单来说：git 是你电脑上的本地存档器，而 GitHub 是远在云端的代码社交展厅。以往我们要创建远程仓库或发起合并（PR），总得停下手头的工作，打开浏览器去点好几个按钮。而 gh 就是直接从终端遥控云端展厅的魔法控制器。
无论是人类开发者还是像 OpenCode 这样的 AI 智能体，直接通过标准化 CLI 与 GitHub 交互，不仅速度提升 10 倍，更消除了由于网页 UI 变动带来的不确定性，是现代工程自动化的基石。
跨平台安装与环境就绪
在 macOS、Linux 与 Windows 上一键安装官方 GitHub CLI 工具。
GitHub CLI 支持主流的所有操作系统。根据你的电脑环境，在终端复制运行对应的一条命令：
macOS（推荐使用 Homebrew）
brew install gh
Linux（Ubuntu / Debian）
sudo apt update && sudo apt install gh
Windows（使用 winget 或 Scoop）
winget install --id GitHub.cli
在终端中输入 gh --version，如果屏幕输出了类似 gh version 2.x.x 的信息，即代表安装圆满成功！
身份授权：免密连接云端
通过 gh auth 协议完成终端与 GitHub 账号的无缝绑定与凭据管理。
在操纵你的 GitHub 资产前，需要让 gh 知道你是谁。运行官方的交互式登录向导：
gh auth login
选择登录平台
上下键选择 GitHub.com，回车确认。
选择通信协议
推荐选择 HTTPS，新手最稳定且无需繁琐配置 SSH 密钥。
浏览器一键授权
选择 Login with a web browser，终端会给出一个 8 位一次性代码，按回车会自动打开浏览器，粘贴代码点击 Authorize github 即可完成极速绑定。
仓库管理：不碰鼠标建项目
新建、克隆、查看、同步远端仓库，一气呵成。
一键把本地目录推成 GitHub 远程仓库
以前新建项目：先在网页建仓库、复制链接、本地绑定 remote 再 push。现在只需在项目文件夹下一句话搞定：
gh repo create my-awesome-project --public --source=. --remote=origin --push
快速克隆任意开源仓库
不需要到处找 Clone 按钮复制超长 URL，直接输入 拥有者/仓库名：
gh repo clone VastFuture/learning-site-astro
在终端随时在浏览器中打开当前仓库
gh repo view --web
PR 与 Issue 协同流水线
代码评审、创建 Pull Request、合并分支与缺陷追踪的终端化工作流。
团队协作与开源贡献最核心的两个概念是 Pull Request (PR) 和 Issue。使用 gh 可以让你像发聊天消息一样轻松管理它们：
发起 Pull Request（代码合并请求）
在你的分支写完代码并提交后，直接敲下命令，gh 会自动识别改动并引导你填写标题与描述：
gh pr create --title "feat: 优化首页响应式排版" --body "修复了移动端展示溢出的问题"
本地秒级切入别人的 PR 进行审查
想在本地测试同事或开源贡献者提的 PR #42？不需要手动拉取分支：
gh pr checkout 42
快速提报或查看任务缺陷清单
# 查看当前仓库开放的 Issue 清单 gh issue list # 快速新建一个 Bug 反馈 gh issue create --title "发现排版错位" --body "在 1080p 屏幕下存在 2px 溢出"
工业级高频命令速查
精选 20% 最核心指令，满足 80% 日常开发与自动化运维需求。
| 核心场景 | 推荐 gh 命令 | 对应网页动作 |
|---|---|---|
| 登录状态检查 | gh auth status | 查看当前登录账号 |
| 新建远程仓库 | gh repo create <name> --public | 点击 New Repository 按钮 |
| 发起 PR | gh pr create | 点击 Compare & pull request |
| 合并 PR | gh pr merge --squash --delete-branch | 点击 Squash and merge 并删分支 |
| 实时监控 CI | gh run watch | 在 Actions 页面刷新等绿灯 |
| 设置环境变量 | gh secret set API_KEY | 进入 Settings > Secrets 逐个输入 |
学会使用 gh 命令不是为了背诵参数，而是建立一种工业级的研发效率意识。当你习惯在终端里完成从代码编写、版本暂存到远端交付的全过程，你的工程效率将迎来质的飞跃。