不能直接用全局变量实现“Mock友好”的单例，因为裸全局变量无法在测试时被替换，mock工具只能mock接口实现而不能覆盖包级变量，导致测试穿透真实依赖。
为什么不能直接用全局变量实现“Mock友好”的单例
因为 var instance *Service 这种裸全局变量在测试时无法被替换，mock 工具（比如 gomock 或 testify/mock）只能 mock 接口的实现，不能覆盖包级变量。一旦业务代码直接调用 GetInstance() 返回的实例，而该实例又硬编码依赖了真实外部服务（如 DB、HTTP 客户端），测试就会穿透到真实环境。
- 常见错误现象：
go test报错connection refused或等待超时，实际是调用了未 stub 的真实依赖 - 根本原因：单例初始化逻辑和接口绑定耦合在
init()或首次调用中，没留出注入点 - 正确思路：把“谁来创建实例”和“谁来使用实例”解耦 —— 创建交给初始化函数或 DI 容器，使用只依赖接口
用接口+私有实现+导出构造函数替代包级变量
不暴露具体类型，只导出接口和工厂函数，让调用方按需获取（甚至可传入 mock 实现）。这才是 Go 风格的“可测试单例”。
- 使用场景：需要全局唯一、但测试时必须替换行为的服务，比如
Logger、CacheClient、MetricsReporter - 关键设计：
type Cache interface { Get(key string) (string, error) }+func NewCache() Cache，而非var DefaultCache Cache - 参数差异：
NewCache()可接收配置（如redis.Addr），而全局变量无法动态调整 - 性能影响：无额外开销 —— Go 编译器能内联简单工厂函数；且避免反射或接口动态查找
测试时如何安全替换单例实现
不是靠“重写变量”，而是靠“控制初始化时机”和“显式传入”。Go 没有运行时变量重绑定，强行用 unsafe 或 reflect 改写包级变量会破坏内存安全，也绕过 go vet 检查。
- 常见错误：在
TestXxx里写myPackage.instance = &mockCache{}—— 编译失败，因为instance是非导出字段 - 正确做法：把单例作为依赖传入被测对象，例如
func NewHandler(c Cache) *Handler，测试时传 mock - 如果必须全局可用（如中间件），用函数变量代替结构体字段：
var GetCache = func() Cache { return NewCache() }，测试中可临时覆盖为GetCache = func() Cache { return &mockCache{} } - 注意：这种函数变量替换仅在单 goroutine 测试中安全；并发测试需用
t.Cleanup恢复原值
为什么不用 sync.Once + 接口字段是更稳妥的选择
sync.Once 确保初始化一次，但它本身不解决“如何注入 mock”的问题。真正关键的是：初始化函数是否接受依赖参数，以及实例是否通过接口暴露。
立即学习“go语言免费学习笔记（深入）”；
- 典型可靠模式：
var ( once sync.Once cache Cache ) func GetCache() Cache { once.Do(func() { cache = NewRedisCache(config) }) return cache } - 这个模式的问题：仍无法在测试中提前设置
cache——once.Do只执行一次，且内部硬编码了NewRedisCache - 改进方案：把初始化逻辑外移，
InitCache(c Cache)显式设定，GetCache()只做空检查返回；测试前调用InitCache(&mockCache{}) - 兼容性提醒：若已有大量代码调用
GetCache().Get(...)，优先改初始化入口，而非重构所有调用点
