googleapis/google-cloud-go
运维与部署Google Cloud 各服务的官方 Go 客户端库,涵盖 Firestore、Storage、Pub/Sub 等。
项目介绍
这个仓库发布调用 Google Cloud Platform 各项服务的官方 Go 包。每个服务对应 cloud.google.com/go 下的独立导入路径,例如 cloud.google.com/go/firestore 或 cloud.google.com/go/storage,Go 应用可以直接创建类型化的客户端,不必手写 HTTP 请求。目标用户是使用 Go 开发并接入 Google Cloud 的开发者,部署环境可以是 App Engine、Cloud Functions、Cloud Run,也可以是外部服务器。
快速使用
- 安装所需服务的包,把示例中的
firestore换成目标包:
go get cloud.google.com/go/firestore@latest
- 创建客户端。在 Compute Engine、Kubernetes Engine 或 App Engine 等 Google Cloud 环境中运行时,Application Default Credentials 会自动生效:
client, err := storage.NewClient(ctx)
- 本地开发时,用 Google Cloud CLI 执行
gcloud auth application-default login写入用户凭据,Application Default Credentials 会自动识别。若改用服务账号密钥文件,可把GOOGLE_APPLICATION_CREDENTIALS设为密钥路径,或向NewClient传入option.WithCredentialsFile。
要确认具体服务是否已发布,可查看 API 参考文档 和 Go 包索引。
使用约束
- 库兼容最近两个 Go 主版本,README 当前列出的是 Go 1.26 和 Go 1.27。
- 需要完成认证:要么在带身份的 Google Cloud 环境中运行,要么在本地配置好 Application Default Credentials 或显式提供服务账号密钥。
- 部分包仍在开发中,可能出现不向后兼容的变更。
- 底层服务的可用性和配额由 Google Cloud 控制,不由客户端库决定。
HotRepo 点评
该仓库在 2026-11-10 的 Go 周榜出现过一次,排在第 20 名,当期新增 2 个 Star;全部语言日榜没有记录到名次。仅凭这一条快照不足以判断趋势。记录显示的是典型的老牌官方 SDK 形态:2014 年创建,现有 4,553 个 Star、1,605 个 Fork,周新增很小。对使用者而言,更重要的是服务覆盖广度以及版本和认证方式,榜单波动本身参考价值有限。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。