能否通过GitHub REST API完成代码克隆、提交推送及GitHub仓库代码更新操作？

云上老周

2026-10-4

GitHub API 常用操作场景使用指南

前置准备

使用GitHub API前需要完成基础配置：

注册GitHub账号，生成对应权限的个人访问令牌（PAT），操作仓库资源需要勾选repo类权限，生成后妥善保管令牌不要泄露。
所有接口请求的Header需携带认证信息：Authorization: token 你的PAT值，同时建议添加Accept: application/vnd.github+json指定响应格式。

代码检出本身可通过Git原生命令完成，GitHub API可辅助获取克隆资源地址或直接下载归档包：

获取仓库克隆地址：调用GET /repos/{所有者用户名}/{仓库名}接口，返回结果中的clone_url为HTTPS克隆地址、ssh_url为SSH克隆地址，拿到地址后直接执行git clone <地址>即可完成代码检出。
下载指定版本归档包：不需要完整Git历史时可直接下载压缩包，调用GET /repos/{所有者用户名}/{仓库名}/zipball/{分支名/标签名/提交哈希}可获取Zip格式归档，将路径中的zipball替换为tarball可获取tar.gz格式归档。

适合仅新增/修改单个文件的场景，无需操作Git对象链：

新增文件：调用PUT /repos/{所有者用户名}/{仓库名}/contents/{文件路径}接口，请求体需携带三个必填参数：
- message：本次提交的说明信息
- content：文件内容的Base64编码值
- branch：要提交的目标分支，不填默认提交到仓库默认分支
  参考请求体结构：
```
{
  "message": "add config.json",
  "content": "eyJuYW1lIjoidGVzdCIsInZlcnNpb24iOiIxLjAuMCJ9",
  "branch": "main"
}
```
修改已有文件：和新增文件调用同一接口，额外多传一个sha参数即可，该值为当前要修改文件的最新哈希，可提前调用GET /repos/{所有者用户名}/{仓库名}/contents/{文件路径}接口获取。

需要将多个文件的变更合并到同一条提交记录时，需要按Git对象流程操作：

获取目标分支的最新提交哈希：调用GET /repos/{所有者用户名}/{仓库名}/git/refs/heads/{分支名}，取返回结果中object.sha的值。
获取最新提交对应的树对象哈希：调用GET /repos/{所有者用户名}/{仓库名}/git/commits/{上一步拿到的提交哈希}，取返回结果中tree.sha的值。
为每个要变更的文件创建Blob对象：调用POST /repos/{所有者用户名}/{仓库名}/git/blobs，请求体传content（文件原始内容）、encoding（填utf-8），每个文件单独调用一次，拿到每个文件对应的Blob哈希。
创建新的树对象：调用POST /repos/{所有者用户名}/{仓库名}/git/trees，参数base_tree填第2步拿到的旧树哈希，tree参数为数组，每个元素对应一个变更文件，包含path（文件路径）、mode（普通文件填100644）、type（填blob）、sha（第3步拿到的对应文件Blob哈希），调用后拿到新树的哈希。
创建新的提交对象：调用POST /repos/{所有者用户名}/{仓库名}/git/commits，参数message为提交信息，parents为数组，填入第1步拿到的最新提交哈希，tree填第4步拿到的新树哈希，调用后拿到新提交的哈希。
更新分支指针：调用PATCH /repos/{所有者用户名}/{仓库名}/git/refs/heads/{分支名}，参数sha填第5步拿到的新提交哈希，需要强制更新时可额外传force: true。

内容的提问来源于stack exchange，提问作者Subramanian Natarajan