gh

GitHub 的官方 CLI 工具，可在终端中高效执行 GitHub 操作的开源软件。

gh

概述

gh 是 GitHub 官方开发的命令行界面（CLI）工具，使用户能够在终端环境中轻松使用 GitHub 的主要功能。自 2020 年首次发布以来，已被开发者广泛采用，通过与 Git 命令的集成，可直接在本地控制问题管理、拉取请求、发布、Actions 等 GitHub 工作流。作为一个开源项目，它与 GitHub Actions 的集成不断增强，在 DevOps 管道中扮演重要角色。

主要内容

安装与配置

gh 支持 macOS、Windows、Linux 等主流操作系统，可通过包管理器（Homebrew、apt、scoop 等）轻松安装。安装后使用 gh auth login 命令进行 GitHub 账户认证，通过 OAuth 或 SSH 密钥安全连接。配置文件存储在 ~/.config/gh/ 中，可根据用户环境进行自定义。

核心命令

gh repo：仓库管理，如创建、克隆、复刻、查看等。示例：gh repo create my-project --public
gh pr：拉取请求的创建、检出、审查、合并。示例：gh pr create --base main --title "New feature"
gh issue：问题的创建、列表查看、评论。示例：gh issue list --label bug
gh run：GitHub Actions 工作流的执行与日志查看。示例：gh run watch
gh release：发布的创建、上传、下载。示例：gh release create v1.0 --notes "First release"
gh gist：Gist 的创建与列表查看。示例：gh gist create file.txt

工作流集成

gh 与 Git 命令自然集成。例如，git push 后可直接使用 gh pr create 创建拉取请求，或使用 gh pr checkout 123 切换到特定 PR 的分支。此外，通过 gh alias 可创建自定义快捷命令以提高生产力。与 GitHub Actions 的集成在 CI/CD 管道中尤其有用，gh run 命令可实时监控工作流状态。

扩展性与插件

gh 支持扩展系统，可安装社区开发的各种插件。使用 gh extension install 命令激活附加功能，例如 gh copilot 扩展提供基于 AI 的命令建议。官方扩展列表可在 GitHub Marketplace 中查看，用户也可自行开发。

安全与认证

gh 支持通过 HTTPS 或 SSH 进行认证，默认使用基于令牌的认证。使用 gh auth status 查看当前认证状态，gh auth logout 结束会话。同时支持企业版 GitHub 服务器，可通过 gh auth login --hostname enterprise.example.com 进行配置。在双因素认证（2FA）环境下也能顺畅运行。

gh

gh

概述