github cli 是官方终端工具，支持跨平台管理仓库、拉取请求和议题；需先安装 git 并配置用户信息，再通过包管理器或手动下载安装，最后运行 gh auth login 完成认证。
GitHub 命令行工具（GitHub CLI）是一个官方提供的终端命令行程序，用于在不离开终端环境的情况下直接与 GitHub 交互。它支持管理仓库、创建和审查拉取请求、处理议题、运行操作等工作。以下是安装与使用该工具的具体步骤：
一、确认系统兼容性与前提条件
GitHub CLI 支持 macOS、Linux 和 Windows 系统，需确保已安装 Git 并配置好全局用户信息，否则部分命令将无法正常提交身份标识。同时，终端需具备 HTTPS 访问能力，以完成登录与 API 通信。
1、打开终端或命令提示符窗口。
2、输入 git --version 验证 Git 是否已安装且版本不低于 2.18。
3、执行 git config --global user.name 和 git config --global user.email，确认用户名与邮箱已设置。
二、通过包管理器安装 GitHub CLI
不同操作系统推荐使用对应包管理器安装，可自动处理依赖并便于后续更新。该方式安装的二进制文件通常置于系统 PATH 中，支持全局调用。
1、macOS 用户执行：brew install gh（需先安装 Homebrew）。
2、Ubuntu/Debian 系统执行：sudo apt install gh（需启用官方 GitHub APT 仓库）。
3、Windows 用户执行：scoop install gh（需预先安装 Scoop）。
三、通过预编译二进制文件手动安装
适用于无包管理器权限、离线环境或需指定版本的场景。下载后需手动解压并添加至系统 PATH，确保 gh 命令可在任意目录执行。
1、访问 https://github.com/cli/cli/releases 页面，找到最新稳定版的 .tar.gz（Linux/macOS）或 .zip（Windows）文件。
2、下载完成后解压归档，提取其中的 gh 可执行文件。
3、将该文件所在目录路径添加到系统环境变量 PATH 中，例如 Linux/macOS 编辑 ~/.bashrc 或 ~/.zshrc，追加 export PATH="$PATH:/path/to/gh"。
四、完成身份认证与初始化配置
首次运行 gh 命令时会触发登录流程，通过浏览器授权或设备流完成 GitHub 账户绑定，并生成本地认证令牌。该令牌存储于 ~/.config/gh/hosts.yml，用于后续所有 API 请求的身份验证。
1、在终端中输入 gh auth login 启动登录向导。
2、根据提示选择 GitHub.com 或 GitHub Enterprise Server。
3、选择 Login with a web browser，复制显示的授权码，在浏览器中打开链接并粘贴授权码完成绑定。
五、常用基础命令操作示例
安装并认证后，可通过 gh 命令快速执行高频操作，所有命令均以 gh 为前缀，子命令语义清晰，参数简洁。以下为典型工作流中的核心指令。
1、克隆远程仓库：gh repo clone owner/repo-name。
2、创建新拉取请求：gh pr create --title "描述标题" --body "详细说明"。
3、查看当前用户的未关闭议题：gh issue list --state open --assignee @me。
