Golang如何实现单例模式 Golang单例设计指南-Golang-PHP中文网

Golang如何实现单例模式 Golang单例设计指南

裘德小鎮的故事

发布： 2025-06-25 20:56:01

原创

406人浏览过

单例模式在golang中确保一个类型在整个应用生命周期内只有一个实例。主要实现方式包括：1. 使用sync.once，这是最推荐的方式，通过once.do保证初始化函数仅执行一次；2. 使用互斥锁（mutex）结合双重检查锁机制，减少锁竞争；3. 饿汉式单例，在程序启动时即创建实例。为提高测试性，可通过接口实现mock。相较于全局变量，单例模式提供更佳的控制与扩展能力。最佳实践是优先使用sync.once，并结合接口设计以提升可测试性。

Golang如何实现单例模式 Golang单例设计指南

单例模式在Golang中，就是确保一个类型在整个应用生命周期内只有一个实例。实现方式有很多种，但核心目标是一致的：控制实例创建，并提供全局访问点。

解决方案

在Golang中实现单例模式，主要有几种常见方法，每种方法都有其优缺点，适用于不同的场景。

使用sync.Once

立即学习“go语言免费学习笔记（深入）”；

sync.Once是Golang标准库提供的，专门用于保证某个函数只执行一次。这是最推荐、最简洁、最安全的方式。
```
package singleton

import "sync"

type singleton struct {
    data string
}

var (
    instance *singleton
    once     sync.Once
)

func GetInstance() *singleton {
    once.Do(func() {
        instance = &singleton{data: "Initial Data"}
    })
    return instance
}

func (s *singleton) GetData() string {
    return s.data
}

func (s *singleton) SetData(data string) {
    s.data = data
}
```
登录后复制
once.Do接收一个函数作为参数，这个函数只会被执行一次，即使在高并发环境下也是如此。 GetInstance()方法返回单例实例。第一次调用时，once.Do会执行初始化函数；后续调用会直接返回已存在的实例。

使用互斥锁（Mutex）

互斥锁可以确保在多线程环境下只有一个goroutine可以访问共享资源。

package singleton

import "sync"

type singleton struct {
    data string
}

var (
    instance *singleton
    lock     = &sync.Mutex{}
)

func GetInstance() *singleton {
    if instance == nil {
        lock.Lock()
        defer lock.Unlock()
        if instance == nil { // Double-Check Locking
            instance = &singleton{data: "Initial Data"}
        }
    }
    return instance
}

func (s *singleton) GetData() string {
    return s.data
}

func (s *singleton) SetData(data string) {
    s.data = data
}

登录后复制

这种方法使用了双重检查锁（Double-Check Locking），首先检查实例是否已经创建，如果未创建，则加锁，再次检查，然后创建实例。这种方法相对复杂，但可以减少锁的竞争。

饿汉式单例

在程序启动时就创建单例实例。

package singleton

type singleton struct {
    data string
}

var instance = &singleton{data: "Initial Data"} // 饿汉式

func GetInstance() *singleton {
    return instance
}

func (s *singleton) GetData() string {
    return s.data
}

func (s *singleton) SetData(data string) {
    s.data = data
}

登录后复制

这种方式简单直接，但缺点是在程序启动时就创建实例，即使程序可能不需要使用这个实例。

如何在测试中mock单例？

单例模式的一个常见问题是难以进行单元测试，因为单例实例是全局的，难以替换。一个常见的解决方法是使用接口。

package singleton

type Singleton interface {
    GetData() string
    SetData(data string)
}

type singleton struct {
    data string
}

var (
    instance *singleton
    once     sync.Once
)

func GetInstance() Singleton {
    once.Do(func() {
        instance = &singleton{data: "Initial Data"}
    })
    return instance
}

func (s *singleton) GetData() string {
    return s.data
}

func (s *singleton) SetData(data string) {
    s.data = data
}

登录后复制

现在，在测试中，你可以创建一个实现了Singleton接口的mock对象，并将其注入到需要使用单例的地方。这样做可以提高代码的可测试性。