sync.Once 不保证初始化成功，只确保函数至多执行一次；若f panic，done仍置1，后续调用静默返回；禁止嵌套Do调用以防死锁；Do仅接受无参无返回func，需外部绑定参数；不可复制Once实例；panic后无法外部感知或重试，容错须在函数内处理。
sync.Once 不保证初始化成功，只保证函数至多执行一次 —— 即使 f panic，done 仍会被置为 1，后续调用静默返回，不再重试。
为什么不能在 Do 里嵌套调用另一个 Do
死锁是常见错误。当传入 Do 的函数内部再次调用 sync.Once.Do（尤其是同一个实例），第二个 Do 会尝试加锁，但第一个还没释放 m，导致 goroutine 永久阻塞。
- 示例：
once.Do(func() { once.Do(anotherFunc) })→ 必然死锁 - 即使换用不同
Once实例，若存在循环依赖（A 调 B，B 又调 A），同样可能卡住 - 修复方式：把嵌套逻辑拆到外部，或用 channel + 单独 goroutine 异步触发
Do 的函数签名限制和参数传递陷阱
sync.Once.Do 只接受 func() 类型，不支持参数和返回值。强行捕获变量容易引发竞态或读到未初始化值。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 错误写法：
once.Do(func() { conn = Connect(host, port) })—— 若host、port是闭包变量，且被并发修改，结果不可控 - 正确做法：在
Do外完成参数绑定，例如host, port := host, port; once.Do(func() { conn = Connect(host, port) }) - 不能靠
Do返回值做判断，必须用外部变量（如err或config）配合 nil 检查或原子标志
复制 sync.Once 实例会导致“一次失效”
sync.Once 不可复制 —— 它的字段 done 和 m 是私有且非线程安全拷贝的。哪怕只是嵌入结构体后赋值，副本就完全独立。
立即学习“go语言免费学习笔记（深入）”；
- 危险操作：
type ConfigLoader struct { once sync.Once }，然后c1 := ConfigLoader{}; c2 := c1→c2.once是全新实例 - 更隐蔽的问题：作为 struct 字段时，若该 struct 被传参或返回，Go 默认按值传递，触发复制
- 安全用法：始终将
sync.Once声明为包级变量，或确保其所在 struct 是指针接收（且不被复制）
真正难察觉的是：panic 后你无法从 Do 外部得知失败，也无法重置重试 —— 这不是 bug，是设计契约。所有容错逻辑必须在传入的函数体内自行处理，比如写日志、设全局 error 变量、或用 atomic.Value 存储结果状态。
