Go sync.Once 使用指南：单次初始化的最佳实践

type Once struct {
    done uint32 // 原子操作标记位 
    m    Mutex  // 互斥锁 
}
 
func (o *Once) Do(f func()) 

var (
    instance *Singleton 
    once     sync.Once 
)
 
func GetInstance() *Singleton {
    once.Do(func() {
        instance = &Singleton{Data: "已初始化"}
    })
    return instance 
}

var (
    appConfig *Config 
    loadOnce sync.Once 
)
 
func LoadConfig() *Config {
    loadOnce.Do(func() {
        data, _ := os.ReadFile("config.yaml")
        appConfig = parseYAML(data) // 真实项目需处理错误 
    })
    return appConfig 
}

var (
    dbPool *sql.DB 
    dbOnce sync.Once 
)
 
func GetDB() *sql.DB {
    dbOnce.Do(func() {
        connStr := "user:pass@/dbname"
        dbPool, _ = sql.Open("mysql", connStr) 
        dbPool.SetMaxOpenConns(100)
    })
    return dbPool 
}

type Logger struct {
    // 日志器字段 
}
 
var (
    loggerInstance *Logger 
    loggerOnce     sync.Once 
)
 
func GetLogger() *Logger {
    loggerOnce.Do(func() {
        loggerInstance = &Logger{
            // 初始化字段 
        }
        loggerInstance.Init() 
    })
    return loggerInstance 
}

var loadConfigOnce = sync.OnceValues(func() (*Config, error) {
    data, err := os.ReadFile("config.yaml")
    if err != nil {
        return nil, err 
    }
    return parseYAML(data)
})
 
func GetConfig() (*Config, error) {
    return loadConfigOnce()
}

// ❌ 错误写法（闭包捕获循环变量）
for _, url := range urls {
    go func() {
        once.Do(func() { 
            fetch(url) // 实际只会执行最后一次循环的url 
        })
    }()
}
 
// ✅ 正确写法 
for _, url := range urls {
    u := url // 创建局部变量副本 
    go func() {
        once.Do(func() { 
            fetch(u) 
        })
    }()
}