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

如何通过 GitHub API 获取用户全部仓库（含私有与公有）

本文详解如何使用 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 权限与请求范围，方可确保私有仓库一并纳入结果集。