sync.Once.Do 不仅确保被调用函数仅执行一次，更关键的是它通过 Go 内存模型提供跨协程的强可见性保证：函数内完成的所有写操作（包括结构体多个字段的初始化）对后续任意 goroutine 中的读操作均可见，无需额外同步。
`sync.once.do` 不仅确保被调用函数仅执行一次，更关键的是它通过 go 内存模型提供跨协程的强可见性保证：函数内完成的所有写操作（包括结构体多个字段的初始化）对后续任意 goroutine 中的读操作均可见，无需额外同步。
在 Go 并发编程中，sync.Once 是实现线程安全单例初始化的常用工具。许多开发者知道它能防止重复执行，但容易忽略其背后强大的内存同步语义——这恰恰是 sync.Once.Do 区别于普通互斥锁或原子操作的关键优势。
根据 Go 内存模型文档，once.Do(f) 的执行满足严格的 happens-before 关系：
- f() 的全部执行过程（包括其中所有读写操作）happens before 任意 once.Do(f) 调用的返回；
- 因此，f() 中对任何变量（无论全局变量、包级变量，还是结构体字段）的写入，都对后续所有 goroutine 中读取这些变量的操作可见。
这意味着：即使 f() 初始化一个包含多个字段的结构体，只要该结构体的指针（或字段本身）在 f() 返回前完成赋值，所有字段的值都将被其他 goroutine 安全观测到。例如：
极品模板多语言企业网站管理系统1.2.2
下载
【极品模板】出品的一款功能强大、安全性高、调用简单、扩展灵活的响应式多语言企业网站管理系统。 产品主要功能如下： 01、支持多语言扩展（独立内容表，可一键复制中文版数据） 02、支持一键修改后台路径； 03、杜绝常见弱口令，内置多种参数过滤、有效防范常见XSS； 04、支持文件分片上传功能，实现大文件轻松上传； 05、支持一键获取微信公众号文章（保存文章的图片到本地服务器）； 06、支持一键
type Config struct {
Timeout int
Retries int
Endpoint string
}
var once sync.Once
var config *Config
func initConfig() {
// 所有字段写入均发生在 f() 内，且在 once.Do 返回前完成
config = &Config{
Timeout: 30,
Retries: 3,
Endpoint: "https://api.example.com",
}
}
func GetConfig() *Config {
once.Do(initConfig)
return config // ✅ 安全：config 及其所有字段均可见
}⚠️ 注意事项：
- 可见性前提是：读操作必须发生在 once.Do 返回之后。若其他 goroutine 在 once.Do 尚未返回时就尝试读取（如通过非同步方式轮询 config != nil），则无法保证可见性；
- config 本身需为包级变量或以指针/引用方式共享；若在 initConfig 中仅修改局部结构体副本，则无意义；
- 不要将 sync.Once 与 sync.Mutex 混淆：前者提供一次性+内存屏障双重保障，后者仅提供临界区互斥，不隐含跨 goroutine 的写后读可见性（除非显式加锁读取）。
总结来说，sync.Once.Do 是 Go 中少数几个自带“发布语义”（publish semantics）的原语之一。它天然适合作为配置加载、资源初始化、单例构建等场景的基石——你只需专注逻辑正确性，内存一致性由运行时严格保障。
