使用 sync.Once 实现单例，确保全局唯一实例：定义私有变量和 once，通过 GetInstance() 调用 once.Do() 初始化，支持线程安全延迟创建；需传参时应在初始化阶段显式调用 Init() 注入配置，避免在 init 或 if 判断中创建以防并发问题；推荐依赖注入替代全局单例以提升可测试性。

在 Go 语言中实现单例模式，核心是确保一个结构体（或类型）在整个程序生命周期中只存在唯一实例，并提供全局、线程安全的访问方式。Go 没有类和构造函数的概念，但可以通过包级变量 + sync.Once 实现简洁、高效、并发安全的单例。

使用 sync.Once 保证初始化仅一次

sync.Once 是 Go 标准库提供的工具，能确保某个函数在多协程环境下只执行一次。这是实现线程安全单例最推荐的方式。

• 定义一个私有全局变量（如 instance *Singleton）
• 定义一个私有 sync.Once 变量
• 提供公有方法（如 GetInstance()），内部用 once.Do() 包裹初始化逻辑

示例：

package singleton

import "sync"

type Singleton struct {
    Name string
}

var (
    instance *Singleton
    once     sync.Once
)

func GetInstance() *Singleton {
    once.Do(func() {
        instance = &Singleton{Name: "default"}
    })
    return instance
}

支持传参的单例（延迟初始化 + 配置注入）

若单例需要依赖外部参数（如配置、连接字符串），可将初始化逻辑封装为工厂函数，配合闭包或额外初始化方法实现。

• 不直接在 GetInstance() 中硬编码参数
• 提供 Init(config Config) 方法，首次调用时设置实例；后续调用忽略
• 或改用带参数的 GetSingleton(name string)，但需注意：严格意义上这已不是“单例”，而是对象池变体

更稳妥的做法是：在 main() 或初始化阶段显式调用一次 Init()，再通过无参 GetInstance() 获取。

避免常见陷阱

• 不要用 init() 函数创建单例：虽然能保证只执行一次，但无法控制初始化时机（早于 main），也无法传参或处理错误
• 不要依赖包级变量 + if 判断：如 if instance == nil { instance = &Singleton{} } —— 在并发下不安全
• 慎用反射或 sync.Mutex 手动加锁：性能低，且容易出错；sync.Once 更轻量、语义清晰
• 导出的字段或方法要明确职责：单例本身应尽量无状态，或状态可控；避免隐式共享导致难以测试

单例的替代思路：依赖注入更推荐

Go 社区普遍认为，过度使用全局单例会增加耦合、降低可测试性。更现代的做法是：

• 在 main() 中创建所需对象（如 DB、Logger、Config）
• 通过构造函数或方法参数显式传入依赖
• 配合 Wire（Google）、Dig（Uber）等 DI 框架自动管理生命周期

单例适合真正全局、无状态、不可变或强一致性的组件（如日志器、指标收集器），而非业务服务对象。

基本上就这些。用 sync.Once + 包级变量是最简单、最安全、最 Go 的单例写法，不复杂但容易忽略并发细节。