必须配好凭证，否则90%报错卡在认证；需用绝对路径显式加载json密钥、匹配服务scope；client初始化须传带timeout的context并配置重试；compute api filter语法严格，须url-safe无空格；gcs上传需显式设contenttype。
用 google.golang.org/api 调 GCP API 前必须配好凭证
没设对认证，90% 的报错都卡在这儿，比如 googleapi: Error 401: Request is missing required authentication credential 或 oauth2: cannot fetch token: 400 Bad Request。GCP 不认环境变量里的 GOOGLE_APPLICATION_CREDENTIALS 就算你本地有 JSON 文件也没用——Go 客户端默认只查这个路径，且只在初始化客户端时读一次。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保 JSON 密钥文件路径正确，且 Go 进程有读权限（别用相对路径，用绝对路径更稳）
- 显式加载凭证比依赖环境变量更可控：
creds, err := google.CredentialsFromFile(ctx, "/path/to/key.json", compute.ComputeScope)
- 不同服务需要不同 scope，比如
compute.ComputeScope对应 Compute Engine，storage.ScopeReadWrite对应 Cloud Storage；混用会 403 - 本地开发别用服务账号密钥硬编码进代码，用
gcloud auth application-default login配置 ADC 更安全
cloud.google.com/go 客户端初始化要传 context.Context 和重试配置
直接 new 一个 client 不报错，但一调方法就 panic 或超时，常见于 ComputeClient.Images.List 或 StorageClient.BucketAttrs 这类阻塞操作。根本原因是没传带 timeout 的 context.Context，或者没设重试策略，遇到 GCP 临时抖动就直接失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 永远用
context.WithTimeout(ctx, 30*time.Second)包一层再传给 client 方法 - 重试不是默认开启的：对
cloud.google.com/go/storage，得手动传storage.WithHTTPClient(&http.Client{...})并自定义 Transport；对cloud.google.com/go/compute/apiv1，用option.WithGRPCDialOption(grpc.WithBlock())防止连接挂起 - 别复用同一个
context.Background()到处传，它没有 cancel 机制，goroutine 泄漏风险高
用 google.golang.org/api/compute/v1 列实例时，Filter 字符串写法很脆
想按标签查实例，写成 filter := "labels.env = 'prod'"，结果返回空——因为 GCP Compute API 的 filter 语法不支持单引号，也不接受空格缩进，大小写还敏感。更坑的是错误不报，只是静默过滤掉所有结果。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- filter 必须是 URL-safe 字符串，等号前后不能有空格：
filter := "labels.env=prod" - 多条件用
AND（全大写），不用&&："status=RUNNING AND labels.env=prod" - 字段名必须是 API 文档里声明的，比如
name可以，instanceName不行；查不到时先用gcloud compute instances list --format=json看原始字段名 - 避免在 filter 里用正则或通配符，Compute API 的 filter 不支持
*或~，要用得自己拉全量后 in-memory 过滤
上传对象到 Cloud Storage 时，ObjectHandle.NewWriter 的 ContentType 不填会出乱码
传个 JSON 文件进去，下载回来发现中文变 \u5468\u6708 或直接乱码，控制台里看 Content-Type 是 application/octet-stream。这不是编码问题，是 GCS 默认不猜 MIME 类型，浏览器或下游服务按二进制处理了。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 写入前务必显式设
ObjectHandle.ObjectAttrs.ContentType：w := obj.NewWriter(ctx)<br>w.ObjectAttrs.ContentType = "application/json"
- 小文件（NewWriter 没问题；大文件必须用
NewWriter+ChunkSize配置，否则内存暴涨，示例：w.ChunkSize = 5 * 1024 * 1024 // 5MB
- 如果文件名含扩展名，别指望自动推断——
cloud.google.com/go/storage不做 MIME 推断，得自己用mime.TypeByExtension
GCP 的 Go SDK 表面封装得很厚，但每个 client 实际暴露的控制点非常有限。最容易被忽略的是：scope、filter 语法、context 生命周期、Content-Type 这四件事，它们不出错时不显眼，一出就是线上读写异常。
