如何通过 GitHub API 完整获取用户所有仓库（含私有与公开）-Golang-PHP中文网

如何通过 GitHub API 完整获取用户所有仓库（含私有与公开）

github api 默认分页返回仓库列表，若未手动处理分页逻辑，将遗漏大量仓库；本文详解如何在 go 中使用 google/go-github sdk 遍历全部页面，确保 100% 获取用户所有可见仓库。

github api 默认分页返回仓库列表，若未手动处理分页逻辑，将遗漏大量仓库；本文详解如何在 go 中使用 google/go-github sdk 遍历全部页面，确保 100% 获取用户所有可见仓库。

GitHub API 对资源列表接口（如 /user/repos）强制启用分页机制，默认每页仅返回 30 条记录（可通过 PerPage 参数调整，最大为 100），且不会自动返回全部数据。即使用户拥有 200 个私有+公开仓库，仅调用一次 RepositoriesService.List() 也只会拿到第一页结果——这正是许多开发者在实现 GitHub 登录后仓库展示功能时遇到“仓库缺失”问题的根本原因。

要完整获取所有仓库，必须显式实现分页遍历。google/go-github SDK 提供了标准的 ListOptions 结构体，支持设置 PerPage 和 Page 字段。核心逻辑是：循环请求各页，每次递增 Page 值，直到某页返回结果数量少于 PerPage（表明已到达末页）。

以下为生产就绪的 Go 示例代码（基于 go-github v53+）：

openclaw-gitbak

使用 Git 备份/恢复 OpenClaw 配置和工作区。

下载

import (
    "context"
    "github.com/google/go-github/v53/github"
    "golang.org/x/oauth2"
)

func GetAllUserRepos(ctx context.Context, token string) ([]*github.Repository, error) {
    ts := oauth2.StaticTokenSource(
        &oauth2.Token{AccessToken: token},
    )
    tc := oauth2.NewClient(ctx, ts)

    client := github.NewClient(tc)
    var allRepos []*github.Repository
    opt := &github.RepositoryListOptions{
        Type:     "all",      // 包含 public + private + forks（需对应权限）
        PerPage:  100,        // 最大单页数量，减少请求数
        Page:     1,          // 起始页码（API 从 1 开始）
    }

    for {
        repos, resp, err := client.Repositories.List(ctx, "", opt)
        if err != nil {
            return nil, err
        }
        allRepos = append(allRepos, repos...)

        // 检查是否还有下一页
        if resp.NextPage == 0 {
            break
        }
        opt.Page = resp.NextPage
    }

    return allRepos, nil
}

⚠️ 关键注意事项：

认证权限：确保 OAuth App 已申请 repo scope（而非仅 public_repo），否则私有仓库将被静默过滤；
速率限制：带认证的请求限速为 5000 次/小时，100 条/页可显著降低请求数（200 个仓库仅需 2 次请求）；
错误处理：实际项目中应增加 resp.Rate.Remaining 监控与重试逻辑；
Type 参数：设为 "all" 才能同时获取 public、private 和 forks；设为 "owner" 可排除 fork（推荐业务场景使用）；
上下文超时：务必为 ctx 设置合理超时（如 context.WithTimeout(ctx, 30*time.Second)），避免阻塞。

总结：GitHub API 的分页不是可选项，而是强制契约。忽略 Page 迭代等于主动放弃大部分数据。通过结构化分页循环、合理设置 PerPage、校验 scope 权限，即可稳定、高效地拉取用户全部仓库，为后续授权管理、CI/CD 集成等场景打下可靠基础。