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+）：
辅助阅读和快速理解 GitHub/Git 项目结构与核心价值的结构化方法论。 当用户请求"分析这个 GitHub 项目"、"帮我读一下这个 repo"、"了解这个项目是做什么的"、 "怎么用这个项目"、"怎么跑这个项目"、"这个项目用了哪些技术"，或任何涉及 GitHub/Git 仓库阅读、理解、技术评估、快速上...
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 集成等场景打下可靠基础。
