本文详解如何使用 github rest api 和 go-github 客户端在 go 项目中完整获取用户的全部仓库（包括私有和公开），重点解决因分页限制导致部分仓库遗漏的问题，并提供可落地的分页遍历实现方案。
本文详解如何使用 github rest api 和 go-github 客户端在 go 项目中完整获取用户的全部仓库（包括私有和公开），重点解决因分页限制导致部分仓库遗漏的问题，并提供可落地的分页遍历实现方案。
GitHub API 默认对列表接口（如 /user/repos）启用分页机制，每次请求仅返回最多 30 条（或指定 per_page 值）记录。若用户拥有数十甚至上百个仓库（尤其含私有库），仅调用一次 RepositoriesService.List() 将必然遗漏大量结果——这正是问题的根本原因。
要获取全部仓库，必须显式处理分页：通过循环调用并递增 Page 参数，直到某一页返回结果数小于 PerPage 值，即表明已遍历完毕。go-github 库中所有列表方法均接受 github.ListOptions 结构体，其包含 Page 和 PerPage 字段，需主动控制。
以下为生产可用的 Go 示例代码（基于 google/go-github/v53）：
batch-git-url-replace
下载
批量替换指定目录下所有 Git 仓库的远程地址（remote URL）。 当用户需要将 Git 仓库从一个服务器迁移到另一个服务器时使用。 触发词：git remote 替换、git url 批量修改、git 仓库迁移、更换 git 地址、批量修改 remote url。
import (
"context"
"log"
"github.com/google/go-github/v53/github"
"golang.org/x/oauth2"
)
func getAllRepositories(ctx context.Context, client *github.Client, token string) ([]*github.Repository, error) {
var allRepos []*github.Repository
opt := &github.RepositoryListOptions{
Type: "all", // 确保包含 private + public
PerPage: 100, // 最大支持值，减少请求数
Page: 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
}
// 使用示例
func main() {
ctx := context.Background()
ts := oauth2.StaticTokenSource(
&oauth2.Token{AccessToken: "your_personal_access_token"},
)
tc := oauth2.NewClient(ctx, ts)
client := github.NewClient(tc)
repos, err := getAllRepositories(ctx, client, "your_token")
if err != nil {
log.Fatal(err)
}
log.Printf("Fetched %d repositories", len(repos))
}⚠️ 关键注意事项：
- 认证权限：确保 Personal Access Token 具备 repo 范围权限（而非仅 public_repo），否则私有仓库将被静默过滤；
- 速率限制：未认证请求限速 60 次/小时，认证后升至 5000 次/小时。上述分页逻辑天然兼容 RateLimit 头部，建议结合 resp.Rate.Remaining 做优雅降级；
- Type: "all" 必须显式设置：默认值为 "owner"，但为明确覆盖所有类型（all / owner / member），推荐显式声明；
- 错误处理不可省略：API 可能返回 403（权限不足）、401（token 失效）等状态，需在循环内校验 err 和 resp.StatusCode；
- 性能优化：PerPage 最高支持 100，应优先设为 100 以减少 HTTP 往返次数。
总结：GitHub API 的分页是设计特性而非缺陷，正确实现分页遍历是获取全量数据的唯一可靠方式。结合 resp.NextPage 自动跳转比手动维护 Page 计数器更健壮，且能规避因响应体缺失导致的边界错误。务必验证 token 权限与请求范围，方可确保私有仓库一并纳入结果集。
