GitHub CLI gh 安装与操作完整指南

约 584 字大约 2 分钟

2026-09-08

gh 是什么

gh 是 GitHub CLI 的简称，GitHub 官方出品的命令行工具。它让开发者直接在终端里操作 GitHub，不需要打开网页，常见能力包括：

对命令行工作流的开发者来说，gh 把 GitHub 操作并入终端，配合脚本可以完成批量操作，例如用 gh issue create --body-file 从本地 Markdown 文件创建 issue。

macOS 上推荐用 Homebrew 安装：

brew install gh

安装完成后验证：

gh --version

其它系统可以从 GitHub CLI 官网下载安装包，Linux 也可用 apt 或 dnf 安装。

gh 需要登录一次才能操作你的账号：

gh auth login

按提示选择：

完成登录后检查状态：

gh auth status

会显示当前登录的账号名和认证方式。

gh issue create --title "标题" --body "问题描述"

多行 Markdown 正文用临时文件传递，避免转义问题：

gh issue create --title "标题" --body-file /tmp/issue.md

gh issue list
gh issue view 123

gh issue view 支持 --json body 查看渲染后的正文，用于验证提交内容是否正确。

gh pr create --title "标题" --body "描述"
gh pr list
gh pr view 456

gh repo view
gh repo clone owner/repo
gh repo fork owner/repo

在 tau 项目中，AGENTS.md 约定创建 issue 和 PR 时用临时文件传正文：

gh issue create --title "标题" --body-file /tmp/issue.md

不使用带转义换行的 --body 字符串，因为 GitHub 会把字面 \n 渲染成文本而不是换行。正文用 Markdown 标题、空行、列表和反引号组织，创建后可用 gh issue view 123 --json body 验证渲染结果。