GitHub CLI 新手指南在终端里管理 PR、Issue 与仓库的完整上手路径【免费下载链接】cliGitHub’s official command line tool项目地址: https://gitcode.com/GitHub_Trending/cli/cli项目概览GitHub CLI命令名为gh是 GitHub 官方提供的命令行工具把拉取请求Pull Request即代码合并请求、议题Issue、仓库等日常协作操作搬进终端。它适合习惯在命令行里写代码、想减少浏览器切换的开发者也能通过 JSON 输出接入脚本和 CI 流程。快速开始安装只需一条命令按你的平台选择即可平台推荐方式注意事项macOSHomebrewbrew install gh已安装时用brew upgrade gh升级WindowsWinGetwinget install --id GitHub.cli也支持 ChocolateyLinuxDebian/Ubuntu官方 APT 仓库后apt install gh需先添加 GPG 密钥和仓库源细节见 docs/install_linux.md各平台的完整说明macOS、Windows、Linux。安装完成后只做两件事就算跑通了gh version # 确认安装成功 gh auth login # 登录你的 GitHub 账号会引导选择登录方式登录成功后建议再执行一次gh auth status确认凭证状态这样能尽早发现网络或授权问题。它适合解决什么问题场景一想快速掌握现在有哪些 PR 需要我处理打开浏览器逐个翻找太慢。gh pr status会按当前分支、我创建的、等待我评审的分类列出 PR 并附带检查状态一条命令看清全局。 推荐入口在任意 git 仓库目录里执行gh pr status。场景二想查看或发起一个议题但不想离开终端gh issue list列出未关闭的议题gh issue create -t 标题直接创建新议题gh issue view 1353查看正文和评论。配合仓库参数--repo 用户/仓库名还能操作非当前目录对应的仓库。 推荐入口议题相关命令源码 可对照阅读参数设计。场景三想把 GitHub 操作写进脚本或 CIgh的输出可以机器化处理多数命令支持--json指定字段和--jq管道过滤gh api则能直接调用 GitHub 的 REST/GraphQL 接口。适合做列出失败的工作流并输出日志按模板批量建 issue这类自动化。 推荐入口语法与参数规则见 docs/command-line-syntax.md接口层实现参考 api/ 目录。场景四本地改完代码后希望一条命令完成推送、建 PR在已推送的分支上执行gh pr create工具会自动复用上游分支信息发起合并请求省去手工填标题、描述和 base 分支的步骤。 推荐入口pr create 实现 展示了分支与远程的推断逻辑。上手建议给新手的三步骤路径先跑通最小闭环再逐步扩展先装好并登录。完成安装后执行gh auth login用gh auth status验证。这一步不通后面所有命令都会报权限错误先在这里排障最省事。挑一个熟悉的小仓库练只读命令。依次运行gh repo view、gh pr list、gh issue list、gh release list熟悉输出格式。只读操作没有副作用可以放心反复执行。完成一次完整的写操作。例如创建一个小 issuegh issue create再把它关掉或者给自己仓库的分支建一个 PR 并合并。跑通一次创建—查看—变更状态的闭环后再去尝试gh api和 JSON 管道这类进阶用法。常见问题与注意事项权限问题Linux 上配置官方包仓库和安装时需要管理员权限sudo。如果make install报权限错误可改用make install prefix/path/to/gh安装到用户目录见 docs/install_source.md。平台差异Windows 上从源码构建没有安装步骤只会在bin\gh.exe生成二进制文件macOS 除了 Homebrew 也提供预编译包。不同平台升级命令不同不要混用。版本选择工具同时支持 GitHub.com、Enterprise Cloud 和 Enterprise Server 2.20 及以上版本。如果你在公司 GHE 环境使用先确认服务端版本再排查问题。登录方式gh auth login支持浏览器授权和粘贴个人访问令牌Token两种方式。在无图形界面的服务器上建议直接用 token 登录避免卡在浏览器跳转。网络限制公司网络若拦截 GitHub 域名安装和登录都会失败。先检查能否访问cli.github.com与api.github.com必要时配置代理环境变量。命令不生效先跑gh version确认安装若 PATH 里找不到检查包管理器默认安装目录是否在你的 PATH 中。延伸阅读各平台安装细节macOS、Linux、Windows从源码构建docs/install_source.md构建前需先安装 Go 1.26命令语法与参数规范docs/command-line-syntax.md设计文档风格与排版约定docs/primer/验收测试样例可当命令怎么写的参考用例acceptance/testdata/源码构建入口pkg/cmd/root/ 是命令注册总览PR 相关实现见 pkg/cmd/pr/如需本地阅读源码可克隆仓库git clone https://gitcode.com/GitHub_Trending/cli/cli 建议把gh 命令 --help当成本地手册用每个命令的帮助文本都带了参数说明和示例。【免费下载链接】cliGitHub’s official command line tool项目地址: https://gitcode.com/GitHub_Trending/cli/cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考