最稳妥方式是使用 google/go-github 官方库，它自动处理分页、限速、认证与版本升级；需用 Personal Access Token 认证并正确传入 Authorization 头，注意 v61 版本字段命名变化及 Rate 限速等待逻辑。
Go 语言调用 GitHub API 最稳妥的方式是用官方维护的 google/go-github 客户端库，而不是手写 HTTP 请求——它自动处理分页、速率限制、认证头、API 版本升级等细节，省掉大量边界问题。
用 github.NewClient 初始化带认证的客户端
未认证请求每小时限速 60 次；带 Personal Access Token（PAT）可升至 5000 次/小时，且能访问私有仓库。Token 必须通过 Authorization: Bearer <token></token> 传入，不能放 URL 或 query 参数里。
- 从 GitHub Settings → Tokens → Generate new token 创建 PAT，至少勾选
repo（读私有库）或public_repo（只读公开库） - 初始化客户端时传入
context.Background()和带 token 的http.Client：
import (
"context"
"github.com/google/go-github/v61/github"
"golang.org/x/oauth2"
)
<p>ctx := context.Background()
ts := oauth2.StaticTokenSource(
&oauth2.Token{AccessToken: "ghp_..." },
)
tc := oauth2.NewClient(ctx, ts)</p><p>client := github.NewClient(tc)
注意：v61 是当前最新主版本号（截至 2024 年中），不同 vN 版本间结构体字段名可能变化，比如 Repository.Name 在旧版是 Repository.Name，但 Repository.FullName 曾改名为 Repository.GetFullName() —— 查文档时务必核对对应版本。
调用 Repositories.ListByOrg 获取组织仓库列表
这是高频使用场景，但容易忽略分页和错误处理。GitHub 默认只返回前 30 条，必须显式设置 PerPage 和循环 NextPage 才能取全。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
ListByOrg第二个参数是*github.RepositoryListByOrgOptions，不是普通 map 或 struct 字面量 -
Sort和Direction是可选字段，不设则按更新时间降序；设了却拼错值（如"asc"写成"acs"）会导致静默忽略排序 - 响应非 2xx 时，
error不为 nil，且*github.Response里含Response.StatusCode和Response.Body原始内容，可用于调试
opt := &github.RepositoryListByOrgOptions{
Type: "all",
Sort: "updated",
Direction: "desc",
ListOptions: github.ListOptions{PerPage: 100},
}
repos, resp, err := client.Repositories.ListByOrg(ctx, "kubernetes", opt)
if err != nil {
if resp != nil && resp.StatusCode == 404 {
log.Println("组织不存在或无访问权限")
}
log.Fatal(err)
}
处理 403 rate limit exceeded 错误
即使用了 token，仍可能触发限速：GitHub 按「每小时请求数」+「每分钟突发请求数」双重限制。直接 panic 或重试会失败，得检查响应头并等待。
- 每次响应的
*github.Response都带Rate字段：resp.Rate.Limit、resp.Rate.Remaining、resp.Rate.Reset（Unix 时间戳） - 若
Remaining == 0，应 sleep 到Reset时间点后再继续，而不是盲目重试 - 别依赖
time.Sleep(1 * time.Second)等固定延迟——Rate.Reset 可能距现在还有 5 分钟
if resp.Rate.Remaining == 0 {
resetTime := time.Unix(resp.Rate.Reset, 0)
sleepDur := time.Until(resetTime) + 1*time.Second
log.Printf("rate limited; sleeping %.1fs", sleepDur.Seconds())
time.Sleep(sleepDur)
}
真正麻烦的不是调不通，而是某些字段在 API 响应里存在但 SDK 结构体没导出（比如 Repository.Topics 在 v61 才加进 Repository），或者文档写的是 REST 路径但 SDK 方法名不一致（GET /user/starred 对应的是 Activity.ListStarredForUser 而非 User.ListStarred）。查不到字段时，先翻 go-github 的 github/ 目录下对应 struct 定义，比看 REST 文档更快。
