Visual Studio 2010 StringBuilder.EnsureCapacity 行為變更：從「倍增補足」改為「精確配置」

.NET Framework 4.0 (VS 2010) 修改了 StringBuilder.EnsureCapacity 的擴容策略。舊版（.NET 2.0/3.5）採用「倍增補足」：先將容量加倍，若仍小於需求則取需求值；新版直接配置精確需求值。本文驗證差異並分析影響。

舊版行為（.NET 3.5 驗證）

StringBuilder sb = new StringBuilder("Hello Kitty!"); // Length=12, Capacity=16 (預設)
sb.EnsureCapacity(28); // 要求 28
Console.WriteLine($"Capacity = {sb.Capacity}"); // 輸出 32 (16*2=32 > 28)

新版行為（.NET 4.0 / VS 2010 驗證）

StringBuilder sb = new StringBuilder("Hello Kitty!"); // Length=12, Capacity=16
sb.EnsureCapacity(28);
Console.WriteLine($"Capacity = {sb.Capacity}"); // 輸出 28 (精確配置)

差異總結

影響分析

• 記憶體使用：新策略避免過度配置，長字串建構場景（如大型 XML/JSON 序列化）記憶體佔用更平滑。
• 效能：舊策略透過倍增減少重新配置次數（平攤 O(1)），新策略可能增加配置頻率。但現代記憶體管理器（分代 GC、大型物件堆積）對小幅配置優化極好，實測差異可忽略。
• 相容性：極少數依賴具體 Capacity 值的程式碼可能受影響（如序列化前預估緩衝區大小、互操作固定緩衝區）。建議檢視專案中 EnsureCapacity 呼叫點，確認邏輯不依賴「容量必為 2 的冪次」假設。

原始碼追蹤

.NET 4.0 StringBuilder.cs 相關片段：

public int EnsureCapacity(int capacity)
{
    if (capacity < 0) throw new ArgumentOutOfRangeException(...);
    if (capacity > this.Capacity)
    {
        // 新策略：直接配置需求值（對齊至記憶體管理器粒度）
        Capacity = capacity;
    }
    return this.Capacity;
}

舊版邏輯約為：

int newCapacity = this.Capacity * 2;
if (newCapacity < capacity) newCapacity = capacity;
Capacity = newCapacity;

結語

此變更屬於 .NET 4.0 基礎類別庫優化之一，傾向於「精確配置、減少浪費」。絕大多數應用無感知，僅極少數高效能、大字串、互操作場景需驗證。升級專案時，可在單元測試中加入 Capacity 斷言確保行為預期。