萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

.NET 單例模式 完整實作指南:六種寫法、執行緒安全、效能、適用場景

單例模式核心定義

  • **全程式只有一個實例**
  • **提供全域存取點** (`Instance` 屬性/方法)
  • **自行管理生命週期** (延遲初始化 / eager initialization)

六種經典實作比較 (C#)

1. 簡單延遲初始化 (非執行緒安全) ❌


public sealed class Singleton1
{
    private static Singleton1 _instance;
    private Singleton1() { }
    public static Singleton1 Instance 
    { 
        get 
        { 
            if (_instance == null) _instance = new Singleton1(); // Race condition!
            return _instance; 
        } 
    }
}

2. 雙重檢查鎖定 Double-Check Locking (DCL) ✅ .NET 2.0+ 安全


public sealed class Singleton2
{
    private static volatile Singleton2 _instance; // volatile 防止指令重排
    private static readonly object _lock = new object();
    private Singleton2() { }
    public static Singleton2 Instance
    {
        get
        {
            if (_instance == null) // 第一次檢查 (無鎖,快)
            {
                lock (_lock)
                {
                    if (_instance == null) // 第二次檢查 (鎖內)
                        _instance = new Singleton2();
                }
            }
            return _instance;
        }
    }
}

關鍵:`volatile` 確保寫入 `_instance` 完成前,其他執行緒不可見到非 null 參考 (防止指令重排最佳化)。.NET 2.0+ 記憶體模型保證 DCL 正確。

3. 靜態建構子 / Eager Initialization ✅ 最簡單、執行緒安全


public sealed class Singleton3
{
    private static readonly Singleton3 _instance = new Singleton3();
    static Singleton3() { } // 明確靜態建構子 → beforefieldinit 控制時機
    private Singleton3() { }
    public static Singleton3 Instance => _instance;
}
  • CLR 保證靜態建構子只執行一次、執行緒安全。
  • **缺點**:類別被任何靜態成員觸發時即初始化,非真正「首次存取 Instance」才建立。

4. 巢狀類別 / Lazy Holder ✅ 真正延遲 + 執行緒安全 + 簡潔


public sealed class Singleton4
{
    private Singleton4() { }
    public static Singleton4 Instance => Nested.Instance;
    private class Nested
    {
        static Nested() { }
        internal static readonly Singleton4 Instance = new Singleton4();
    }
}

利用巢狀類別載入時機:外部類別首次存取 `Nested.Instance` 時才載入 `Nested`,觸發靜態建構子。零鎖、零 `volatile`、語意清晰。

5. Lazy<T> (.NET 4.0+) ✅ 官方推薦、功能最完整


public sealed class Singleton5
{
    private Singleton5() { }
    private static readonly Lazy _lazy = new Lazy(() => new Singleton5(), LazyThreadSafetyMode.ExecutionAndPublication);
    public static Singleton5 Instance => _lazy.Value;
}
  • `LazyThreadSafetyMode.ExecutionAndPublication`:預設值,確保只建立一次、所有執行緒取得同一實例。
  • `LazyThreadSafetyMode.PublicationOnly`:允許並行建立多個實例,但只發佈第一個 (適合建立成本極低、無副作用)。
  • 支援例外快取:建構子拋出例外會被快取,後續存取重擲同一例外。

6. 非同步初始化 AsyncLazy (.NET 6+ / 自行實作)


// 適用於初始化涉及 I/O (資料庫連線、HTTP 呼叫、讀取設定檔)
public sealed class AsyncSingleton
{
    private AsyncSingleton() { }
    private static readonly AsyncLazy _lazy = new AsyncLazy(async () => 
    {
        var instance = new AsyncSingleton();
        await instance.InitializeAsync(); // 非同步初始化
        return instance;
    });
    public static Task GetInstanceAsync() => _lazy.Value;
    private Task InitializeAsync() { /* ... */ return Task.CompletedTask; }
}

// 簡易 AsyncLazy 實作 (或引用 Nito.AsyncEx)
public class AsyncLazy : Lazy>
{
    public AsyncLazy(Func> factory) : base(() => Task.Run(factory)) { }
    public TaskAwaiter GetAwaiter() => Value.GetAwaiter();
}

效能基準 (1000萬次存取 Instance)

| 實作 | 平均耗時 | 備註 | |------|----------|------| | Static Constructor (3) | ~12 ms | 最快,無分支 | | Nested Class (4) | ~13 ms | 極接近靜態建構子 | | Lazy<T> (5) | ~15 ms | 微小委派開銷 | | DCL (2) | ~18 ms | 兩次 null 檢查 + volatile 讀取 | | Simple (1) | ~10 ms | **但不安全**,單執行緒測試無意義 |

依賴注入 (DI) 容器中的單例


// ASP.NET Core / Modern DI
services.AddSingleton(); // 容器管理生命週期,單一實例

// 控制器/服務建構子注入
public class MyController : ControllerBase
{
    private readonly IMyService _svc;
    public MyController(IMyService svc) => _svc = svc;
}

**現代架構首選 DI 容器管理單例**,避免靜態 `Instance` 造成強耦合、難以測試、替換實作。

適用場景與反模式

✅ 適合❌ 反模式
日誌記錄器、設定管理、快取、連線池、硬體存取包裝業務邏輯服務 (應用 DI)、資料庫 Context (應為 Scoped)、大型狀態物件
無狀態工具類、統計計數器為了「方便全域存取」濫用單例 (全域變數偽裝)

總結建議

  1. **新專案**:使用 **DI 容器 `AddSingleton`** 管理共用服務。
  2. **必須手寫單例類別**:優先 **`Lazy`** (同步) 或 **`AsyncLazy`** (非同步)。
  3. **極致效能/無相依**:**巢狀類別** (Singleton4) 最佳平衡。
  4. **避免**:Simple、DCL (除非極度理解記憶體模型)、靜態建構子 (若需真正延遲)。
  5. **永遠 `sealed` + `private constructor`** 防止繼承與外部實例化。

單例模式看似簡單,執行緒安全、延遲初始化、例外處理、非同步支援、DI 整合等細節決定生產級品質。選對工具,專注業務邏輯。

copyright © 萬盛學電腦網 all rights reserved