sync.once 不支持任何配置，它仅通过 do 方法确保函数最多执行一次；其内部只有不可导出的 done 标志和互斥锁，无超时、重试或重置机制，行为完全取决于传入的初始化函数。
sync.Once 不是配置项，它本身不支持任何配置——它就是一个结构体，只有 Do 方法，且内部字段 done 和 m 都不可导出、不可修改。所谓“配置”，其实是误读了它的使用意图。
为什么 sync.Once 没有配置参数
sync.Once 的设计目标极其明确：只做一件事——保证某个函数最多执行一次。它的源码里只有两个字段：done uint32（原子标记）和 m Mutex（保护临界区），没有暴露任何可调参数或初始化选项。
- 你不能设置“超时”“重试次数”或“失败后是否重置”——它一旦标记为 done，就永远 done
- 你不能传入 context 或取消信号——
Do只接受func()，无参无返回 - 你也不能复用同一个
sync.Once实例去控制多个不同初始化逻辑——每个独立初始化必须配一个独立的Once
常见误以为能“配置”的操作及其真实含义
很多人把包级变量声明、错误处理封装、懒加载逻辑等当成“配置”，其实它们是使用模式，不是 sync.Once 自身的配置能力。
-
var configOnce sync.Once—— 这只是声明一个实例，不是配置；重复声明多个sync.Once是合法且必要的 - 在
Do里调用os.ReadFile或http.Get—— 这属于业务逻辑，sync.Once不关心里面做什么，只管“执行一次” - 配合
error返回值（如func LoadConfig() (*Config, error)）—— 错误处理必须由你自己实现，sync.Once.Do不捕获 panic，也不返回 error
真正影响行为的关键点：调用时机与初始化函数内容
决定单例是否可靠、是否安全的，从来不是“怎么配 sync.Once”，而是你怎么写那个传给 Do 的函数。
- 如果初始化函数里有阻塞操作（比如未设 timeout 的
net.Dial），所有后续 goroutine 会卡住等待，直到它完成或 panic - 如果初始化函数可能 panic（如空指针解引用、除零），
sync.Once不 recover，调用方直接崩溃，且done仍被置为 1，后续调用永远拿不到有效实例 - 如果初始化函数依赖外部状态（如环境变量变更后想重新加载），
sync.Once无法满足——它天生不可逆，此时应换用带缓存+失效机制的懒加载，而非单例
最常被忽略的一点：你没法在初始化失败后“重试”。一旦 Do 执行过且函数 panic 或返回 nil，你就只能重启进程——sync.Once 没有 reset 接口，也没法绕过它再触发初始化。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
