github cli（gh）是高效管理github仓库的官方命令行工具，核心流程包括：一、安装与认证；二、克隆/创建/初始化仓库；三、创建与管理pr；四、处理issues；五、浏览与搜索数据。
如果您希望在终端中高效管理 GitHub 仓库，而非依赖网页界面，则需要掌握 GitHub CLI（gh）这一官方命令行工具的基本操作流程。以下是完成常见协作任务所需的核心步骤：
一、安装与身份认证
GitHub CLI 必须先安装并登录才能执行任何远程操作，否则所有命令将因未授权而失败。
1、访问 https://cli.github.com 下载对应操作系统的安装包，或使用包管理器安装：macOS 用户运行 brew install gh，Ubuntu 用户运行 sudo apt install gh。
2、在终端中输入 gh auth login，按提示选择 GitHub.com、验证方式（推荐浏览器登录）、默认协议（HTTPS）及默认 Git 主机。
3、终端将自动打开浏览器页面，要求授权 gh 工具访问您的账户；授权完成后，返回终端确认登录成功。
二、克隆与初始化仓库
本地工作流始于获取远程代码或创建新仓库，gh 提供比原生 git 更简捷的入口指令。
1、克隆他人公开仓库：执行 gh repo clone owner/repo-name，例如 gh repo clone cli/cli，自动完成 git clone 并设置 upstream。
2、从模板创建新仓库：运行 gh repo create my-new-project --template=owner/template-repo --public，立即生成带预设结构的远程仓库并关联本地。
3、将已有本地目录变为 GitHub 仓库：进入项目根目录后，运行 gh repo create --source=. --public --push，自动完成初始化、添加远程、首次提交与推送。
三、创建与管理 Pull Request
Pull Request 是 GitHub 协作核心机制，gh 命令可绕过网页表单，直接从终端发起、审查与合并。
1、确保当前分支已推送至远程：执行 git push -u origin HEAD，为后续 PR 提供基础分支引用。
2、创建 PR：运行 gh pr create --title "Add feature X" --body "This implements Y" --assignee @me --reviewer user1,user2，自动打开浏览器跳转至 PR 页面并填充字段。
3、查看当前 PR 状态：输入 gh pr list --state=open，列出所有开启中的 PR 及其编号、标题与作者信息。
4、检出他人 PR 到本地：使用 gh pr checkout 42，自动拉取编号为 42 的 PR 分支并切换至该分支，便于本地复现与测试。
四、处理议题（Issues）
议题是跟踪任务与缺陷的主要载体，gh 支持快速创建、筛选与更新，无需离开终端。
1、新建议题：执行 gh issue create --title "Bug: Button does not respond" --body "Steps to reproduce: 1. Click login. 2. See error in console."，立即提交并返回议题 URL。
2、列出指定状态议题：运行 gh issue list --label "bug" --state all，显示所有带 bug 标签的议题（含关闭项）。
3、更新议题状态：输入 gh issue comment 15 --body "Confirmed on v2.3.0, adding reproduction steps now."，向编号 15 的议题追加评论。
4、关闭议题：使用 gh issue close 15 --comment "Fixed in commit abc123"，同时关闭并附带说明。
五、浏览与交互 GitHub 数据
gh 提供轻量级数据查询能力，适用于快速验证仓库状态、用户权限或事件流。
1、查看仓库详情：运行 gh repo view --web 直接在浏览器中打开当前仓库主页；或使用 gh repo view --json name,description,stars,visibility 输出结构化 JSON 信息。
2、检索用户活动：输入 gh activity --limit 5，列出最近 5 条个人通知（如 PR 评论、议题分配等）。
3、搜索代码：执行 gh search code "fetch('/api')" --repo owner/repo-name --language javascript，在指定仓库中查找特定字符串的 JavaScript 文件。
