GitHub CLI:命令行操作 GitHub

GitHub CLI 是 GitHub 官方推出的命令行工具,让你在终端中轻松管理仓库、Issue、Pull Request 等操作。本文详细介绍其功能、安装步骤与使用技巧,帮助你摆脱鼠标,提升开发效率。

许可证 MIT更新 2026-08-18

详细介绍

为什么你需要 GitHub CLI?

在日常开发中,我们经常要在浏览器和终端之间来回切换:查看 Issue、创建 Pull Request、合并分支、查看 Actions 状态……这些操作不仅打断心流,还容易让人分心。GitHub CLI 正是为了解决这一痛点而生,它将 GitHub 的核心功能直接集成到终端中,让你无需离开命令行即可完成全部工作流。

作为 GitHub 官方开源项目,GitHub CLI 支持 Windows、macOS 和 Linux,且与 GitHub 企业版兼容。它不是一个简单的 API 封装,而是针对开发者习惯精心设计的交互式工具,提供自动补全、交互提示等友好特性。

核心功能:重新定义终端工作流

1. 仓库与 Issue 管理

使用 gh repo clone 克隆仓库,gh issue create 快速提交 Issue,甚至可以用 gh issue list --assignee @me 查看分配给自己的任务。所有操作都支持交互式筛选,比网页端更高效。

2. 流畅的 Pull Request 工作流

创建 PR 只需 gh pr create,会自动填充 diff 和提交信息。合并、查看、评论 PR 同样可以命令行完成:gh pr merge --squash 一键合并,gh pr diff 查看改动。

3. 自动化与扩展能力

GitHub CLI 支持脚本化操作,例如通过 gh run watch 实时查看 Actions 日志,或利用 gh alias set 自定义命令别名。它与 jq 等工具结合,能实现复杂的自动化场景。

安装与使用:从零开始

安装方式因系统而异:

  • macOS(Homebrew)brew install gh
  • Windows(winget)winget install --id GitHub.cli
  • Linux(apt)sudo apt install gh
  • 其他:直接下载预编译二进制文件

安装后运行 gh auth login 按提示完成认证(支持 HTTPS 和 SSH)。验证安装:gh --version

基本示例:gh repo create my-project --public 创建远程仓库,gh issue view 123 查看 Issue,gh pr checkout 456 切换到 PR 分支。

注意事项与技巧

  • 首次使用需完成认证,否则命令会报错。
  • 操作企业版 GitHub 时,需指定 --hostname 参数。
  • GitHub CLI 依赖 Git,请确保 Git 版本在 2.0 以上。
  • 善用 gh help 查看命令帮助,或使用 Tab 键自动补全。
  • 在 CI 中可以使用 GH_TOKEN 环境变量进行无交互认证。

GitHub CLI 已经成了许多开发者效率工具箱中的必备品,它不只是减少操作步骤,更是改变了我们与 GitHub 交互的方式。现在就用起来,体验全命令行的丝滑开发吧。

更新记录

最近更新:2026-08-18

下载

源码地址

下载按优先级提供:国内网盘(第一优先,便于国内快速获取)→ 官方来源(官方正版背书)→ 源码地址(开源项目);网盘链接均经审核,如失效欢迎反馈。

怎么选(决策参考)

解决什么

暂无公开信号

替代什么

暂无公开信号

适合谁

暂无公开信号

不适合谁

暂无公开信号

核心优势

暂无公开信号

主要限制

暂无公开信号

社区信号

社区数据不足

成熟度

暂无公开信号

什么时候选它

暂无公开信号

什么时候不要选它

暂无公开信号

常见问题

GitHub CLI 和 Git 有什么区别?

Git 是版本控制工具,负责本地代码管理;GitHub CLI 是与 GitHub 平台交互的命令行工具,相当于把网页端功能搬到终端,但两者可以配合使用。

GitHub CLI 支持 GitHub 企业版吗?

支持。安装后通过 `gh auth login --hostname 企业域名` 进行认证即可。企业版功能与公共 GitHub 基本一致,但需要管理员权限。

如何卸载 GitHub CLI?

根据安装方式不同:macOS 用 `brew uninstall gh`,Windows 用 `winget uninstall`,Linux 用系统的包管理器卸载命令即可。卸载后配置残留可手动删除。

相关推荐

相关文章