Go语言延迟加载如何使用OnceFunc-Golang-PHP中文网

oncefunc 是 go 1.21 引入的 func() t 类型函数，封装 sync.once 实现懒加载与结果缓存；区别于 sync.once，它更轻量、无状态、无需手动管理变量，且内置类型泛化与结果存储。

go语言延迟加载如何使用oncefunc

OnceFunc 是什么，和 sync.Once 有什么区别

OnceFunc 是 Go 1.21 引入的便捷封装，它把 sync.Once 和闭包逻辑打包成一个函数值，返回一个「懒加载」的、线程安全的调用入口。它不是新类型，而是 func() T 类型的函数——调用它时才首次执行初始化逻辑，并缓存结果；后续调用直接返回缓存值。

和手动写 sync.Once + 全局变量相比，OnceFunc 更轻量、无状态、不依赖外部变量，也更容易测试和复用。它内部仍用 sync.Once 实现，但把双重检查、结果存储、类型泛化都收进标准库了。

如何正确声明和调用 OnceFunc

声明时必须显式指定返回类型（Go 不支持泛型推导函数类型），初始化逻辑写在闭包里：

var getConfig = sync.OnceFunc(func() *Config {
    return &Config{
        DatabaseURL: os.Getenv("DB_URL"),
        Timeout:     30 * time.Second,
    }
})
<p>// 后续任意位置调用，只执行一次
cfg := getConfig() // 第一次调用：执行闭包，缓存返回值
cfg2 := getConfig() // 直接返回缓存的 *Config 指针
</p>

闭包必须是 func() T 形式，不能带参数，也不能返回多个值
返回值会被拷贝（对指针/结构体无影响），但不可变——OnceFunc 不提供重置或清除缓存的能力
不要在闭包里再调用另一个 OnceFunc 或 sync.Once.Do，否则可能死锁（和 sync.Once 同样的限制）

OnceFunc 在延迟初始化场景下的实际表现

它天然适合「按需创建、全局复用」的资源，比如 HTTP 客户端、配置解析器、连接池等。相比手写 sync.Once，它避免了三个常见问题：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

忘记加锁或误用 done 标志位导致竞态
多个地方共享同一个 sync.Once 实例，意外干扰彼此初始化流程
初始化失败后无法重试（OnceFunc 同样不支持重试，但至少错误值也会被缓存，行为更明确）

例如数据库连接初始化失败时：

var getDB = sync.OnceFunc(func() (*sql.DB, error) {
    db, err := sql.Open("pgx", os.Getenv("DSN"))
    if err != nil {
        return nil, err // 错误也会被缓存，后续调用直接返回该 error
    }
    return db, nil
})
<p>db, err := getDB() // err 可能是非 nil；下次调用仍返回同一 err
</p>