Go语言对接又拍云必须使用官方SDK github.com/upyun/go-sdk/upyun，初始化需传入bucket/operator/password三元组，上传文件用PutFile（磁盘路径）或Put（内存数据），公有URL须匹配控制台配置的默认CDN域名，私有空间需调用SignURL签名。
直接用 github.com/upyun/go-sdk/upyun，别碰任何第三方封装或旧版 fork；又拍云 Go SDK 当前无 v2 或语义化版本后缀，upyun 包就是唯一主线，导入路径里不带 /vX，也不需要手动指定版本号（go mod tidy 会自动锁定最新兼容版）。
初始化 client 必须传 bucket/operator/password 三元组
又拍云不走 token 或 accessKey/secretKey 模式，身份认证靠「空间名 + 操作员账号 + 密码」硬绑定。漏掉任一参数，调用 Usage() 或上传都会 panic 或返回 401。
-
bucket是你在又拍云控制台创建的存储空间名，全小写、数字、中划线，不能含下划线或大写字母 -
operator是操作员账号（非主账号），需在控制台「服务设置 → 操作员管理」中单独创建，不能复用主账号登录名 -
password是该操作员的独立密码，不是主账号密码，且不能是弱密码（如 123456），否则控制台会拒绝保存
上传文件必须用 PutFile，传内存数据才用 Put
SDK 提供两个上传入口，但语义和参数完全不同：前者接收本地文件路径字符串，后者接收 []byte。混用会导致上传内容错位——比如把 "./avatar.jpg" 当作二进制数据发出去，结果服务器存的是 14 字节的路径文本。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 上传磁盘文件：
client.PutFile(ctx, "/remote/path.jpg", "./local/avatar.jpg", nil) - 上传内存数据（如 HTTP 请求 body）：
client.Put(ctx, "/remote/path.jpg", dataBytes, nil) -
ctx建议带超时，例如context.WithTimeout(context.Background(), 30*time.Second)，避免因网络卡顿阻塞 goroutine
公有读 URL 构建必须匹配服务域名，不能硬编码
又拍云每个空间对应一个默认 CDN 域名（形如 xxx.b0.upaiyun.com），这个域名在控制台「服务设置 → 域名管理」里可见。用错域名会导致 404 或 403，尤其当空间已绑定自定义域名时，SDK 不会自动识别，得手动拼接。
- 不要写死
"http://xxx.b0.upaiyun.com/" + key—— 如果空间启用了 HTTPS 强制跳转或自定义域名，该链接会失效 - 推荐做法：从控制台复制「默认 CDN 域名」，用它拼接；若用自定义域名，确保该域名已通过 CNAME 解析并开启 CDN 加速
- 私有空间的 URL 需签名，调用
client.SignURL(key, expireSeconds)，注意expireSeconds是相对当前时间的秒数，不是 Unix 时间戳
最易被忽略的是操作员权限粒度——又拍云操作员可配置「路径前缀白名单」，如果上传 key 是 /upload/avatar/123.jpg，但操作员只允许 /public/ 下操作，上传会静默失败（返回 200 但实际没存进去），务必在控制台核对操作员的「路径权限」设置。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
