什么是 GitHub CLI (gh)?
GitHub CLI,简称为 gh,是 GitHub 的官方命令行工具。它将 GitHub 的强大功能带到您的终端,让您无需离开命令行环境即可管理仓库、处理问题(issues)、操作拉取请求(pull requests)以及与 GitHub Actions 互动。它旨在简化您的工作流程,减少上下文切换,并使脚本编写和自动化变得无缝。
主要功能
- 完整的仓库管理: 直接从 CLI 创建、克隆、复刻(fork)和查看仓库。
- 问题和拉取请求: 列表、查看、创建和管理问题及拉取请求。您甚至可以检出 PR 分支、审查代码并合并它们。
- GitHub Actions 集成: 查看工作流状态、实时观看日志以及从工作流运行中下载构建产物。
- Gists 和 Releases: 创建和管理 Gists,并处理软件发布,包括上传资产。
- 可扩展性: 创建自定义命令和别名,以根据您的特定需求和工作流程定制
gh。 - 身份验证: 使用基于浏览器或基于令牌的流程安全地验证您的 GitHub 帐户。
使用场景
- 自动化与脚本: 自动化重复性任务,如创建拉取请求、设置新仓库或批量管理问题。
- CI/CD 集成: 在您的 CI/CD 管道中使用
gh与 GitHub 互动,例如在成功构建后创建一个发布版本。 - 以终端为中心的工作流: 对于习惯在终端中工作的开发人员,
gh提供了一种无需图形用户界面即可执行几乎所有与 GitHub 相关任务的方法。 - 快速状态检查: 使用单个命令快速检查拉取请求的状态或查看项目的最新问题。
入门指南
这是一个简单的“Hello World”风格的指南,帮助您开始使用 gh。
- 安装:
在 macOS 上,您可以使用 Homebrew:
brew install gh对于 Windows 或 Linux 等其他系统,请参阅官方安装指南。
- 身份验证:
登录到您的 GitHub 帐户。此命令将打开一个浏览器窗口,供您授权 CLI。
gh auth login - 创建和克隆仓库:
让我们创建一个新的公共仓库并克隆它。
# 在 GitHub 上创建一个新仓库 gh repo create my-cli-app --public --source=. --remote=origin # 克隆一个现有仓库 gh repo clone cli/cli - 列出问题:
进入克隆仓库的目录并列出其开放的问题。
cd cli gh issue list
定价
GitHub CLI (gh) 是完全免费和开源的,根据 MIT 许可证分发。您可以免费将其用于个人和商业项目。
社区
作为 GitHub 的官方工具,gh 拥有一个庞大而活跃的社区。该项目在 GitHub 上拥有数万颗星,并因其强大的功能集和显著提高开发人员生产力而广受赞誉。反馈绝大多数是积极的,该工具被认为是成熟和稳定的,适合日常使用。