1. 介紹
簡單說:二進位序列化格式會把物件轉成一連串位元組,儘可能緊湊地編碼它的結構與值。想像你不是用文字描述一個物件(像 JSON 或 XML),而是把每個位元精準地按記憶體中的存放方式寫下來。
在文字格式中,資料像寫給朋友的信(每個字元對人類可讀)。二進位格式更像摩爾斯電碼,每個點與劃都儘量短,手動「閱讀」幾乎不可能。
比較:格式對照表
| 格式 | 人可讀 | 檔案大小 | 速度(寫/讀) | 相容性 |
|---|---|---|---|---|
| XML/JSON | 是 | 大 | 較慢 | 好 |
| 二進位 | 否 | 小 | 非常快 | 有限 |
.NET 中二進位序列化如何工作?
在 .NET 生態中,歷史上主要的二進位序列化工具是類別 BinaryFormatter。但隨著平台發展,它被認為不安全並且在 .NET 9 中被移除。現在常用的方法是:BinaryWriter/BinaryReader,以及針對複雜物件的第三方函式庫(例如 protobuf-net)。
簡短的歷史回顧
BinaryFormatter 能把任何標註了屬性 [Serializable] 的類別轉成位元組,並在反序列化時還原物件結構。聽起來像魔術,但其中藏了很多問題(下面會詳述)。
現代工具
對原始型別與簡單結構,使用 BinaryWriter 與 BinaryReader 非常方便。對於複雜物件,則建議用第三方庫(比如 protobuf-net、MessagePack-CSharp 等)。
2. 用 BinaryWriter 序列化原始型別
我們繼續完善教學應用。比如,我們想把使用者設定(使用者名稱、分數、登入時間)寫入二進位檔案。
public class UserProfile
{
public string Name { get; set; }
public int Score { get; set; }
public DateTime LoginTime { get; set; }
}
public static Task SaveUserProfile(UserProfile profile, string filePath)
{
// 開啟檔案寫入
using var stream = new FileStream(filePath, FileMode.Create, FileAccess.Write, FileShare.None);
using var writer = new BinaryWriter(stream);
// 分段寫入資料。先字串,然後整數,然後時間
writer.Write(profile.Name ?? string.Empty); // 字串
writer.Write(profile.Score); // 整數
writer.Write(profile.LoginTime.ToBinary()); // 日期轉成 "long"
}
現在是讀取範例:
public static Task<UserProfile> LoadUserProfile(string filePath)
{
using var stream = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read);
using var reader = new BinaryReader(stream);
string name = reader.ReadString();
int score = reader.ReadInt32();
long dateData = reader.ReadInt64();
DateTime loginTime = DateTime.FromBinary(dateData);
return new UserProfile { Name = name, Score = score, LoginTime = loginTime };
}
原始二進位序列化的特性
使用 BinaryWriter 時,我們逐個屬性序列化。這是可靠且可預期的方式:若資料結構改變,程式碼會直接反映出來。
3. 傳統二進位序列化的問題
現在看另一面。為什麼 Microsoft 那麼強烈反對並禁止 BinaryFormatter 的使用?
格式脆弱(Schema Evolution Hell)
二進位資料與類別結構緊密綁定。改了類別(重命名欄位、新增或刪除欄位)— 舊的二進位檔就會無法讀取。改變屬性順序也會出問題。
示例:
// 昨天
public class Profile
{
public string Name;
public int Score;
}
// 今天
public class Profile
{
public string Name;
public double Rating; // 新增的欄位
public int Score;
}
讀取舊檔可能會拋出錯誤,或者讀到「混亂」的欄位值。和 JSON 或 XML 不同,那些格式可以忽略缺失元素,二進位格式無法自動適應 —— 它像是一條混凝土路:一旦偏離就會「翻車」。
反序列化漏洞
最大的問題是 BinaryFormatter 的潛在漏洞。如果你的軟體會反序列化來自不可靠來源(例如網路上的使用者上傳)的二進位資料,攻擊者可能注入惡意「物件」。過去這類問題甚至導致遠端執行任意程式碼。
跨平台與相容性
二進位序列化通常依賴於 .NET 的內部資料呈現,以及執行環境、編譯器與架構(例如 x64/ARM)。在 Windows 上序列化,然後在 Linux 上反序列化,可能會遇到各種意外!即使在不同的 .NET 版本之間也可能不相容。
診斷不便
遇到文字格式的問題時,可以打開檔案看看內容並推測錯在哪裡。二進位檔案是一個謎。你看到的只是毫無意義的位元組序列。分析它需要特定工具和耐心。
4. 複雜物件的二進位序列化
引用
BinaryFormatter 能記住物件之間的連結(例如兩個屬性指向同一物件),但 BinaryWriter 與大多數第三方庫通常沒有這種魔法。通常的做法是把一個物件嵌入另一個並依序寫出。
循環引用
對於有循環引用的物件(例如「母體」有屬性 Child,而「子體」有屬性 Parent 指回母體),序列化要麼拋錯,要麼導致無窮迴圈。
範例:
public class Node
{
public Node? Next { get; set; }
public Node? Prev { get; set; }
}
天真的序列化這個物件會導致迴圈。
5. 二進位序列化與可攜性
任何二進位格式(尤其是自製格式)通常都是「只給自己用」的格式。如果你打算與其他程式交換資料或長期保存,選擇開放標準:JSON、XML 或 ProtoBuf。
什麼情況下適合用二進位序列化?
- 資料只在同一應用範圍內使用且只需短期保存時。
- 需要速度與緊湊性(例如大量日誌或在同一生態系統內的服務間交換)。
- 你能非常明確地控制雙方:序列化方與反序列化方。
替代方案:protobuf、MessagePack 等
- protobuf-net:Google Protocol Buffers 在 .NET 的移植,適合跨平台交換與相容性。
- MessagePack-CSharp:針對 .NET 的高效 MessagePack 實作。
和「裸」的 BinaryWriter 不同,這些庫實作了 schema、支援格式演化、跨平台性與安全性。如果你需要和其他系統互通,應該使用它們。
6. 「手動」二進位序列化
如果你真的需要寫二進位資料(例如在需要極致效能的情境),使用 BinaryWriter/BinaryReader —— 並且務必明確編碼順序與型別。
建議:
- 始終以固定順序寫入資料,並以相同順序讀取。
- 在變更檔案結構時保留版本號,或寫入「魔數標頭」(Magic Header)。
- 在寫入字串/陣列之前先寫入長度。
- 記錄檔案結構:否則一年後你自己也搞不清格式。
範例:版本控制
// 在最前面存版本號
writer.Write((byte)1); // 版本 1
writer.Write(profile.Name ?? "");
writer.Write(profile.Score);
writer.Write(profile.LoginTime.ToBinary());
/*
允許日後在格式變更時加入條件分支來讀取
*/
7. 二進位序列化常見錯誤
把欄位寫入時的順序改了,但讀取時換了位置。 結果值會「跑位」:字串被當成 int 讀,int 當成日期,等等。
寫入了 10 個物件,但讀取時預期 11。資料流被打斷:會拋出到達檔案結尾的例外。
變更了類別結構,但無法讀取舊的二進位檔 —— 會失去所有歷史資料。
忘了在讀取重要檔案時處理例外 —— 程式在磁碟第一次故障時就崩潰(例如會看到 EndOfStreamException)。
試圖在不同程式語言間交換二進位檔而沒有明確格式 —— 在 99% 的情況下這會是場災難。
反序列化從網路收到的不明資料 —— 歡迎漏洞!別用 BinaryFormatter;驗證輸入並使用安全格式。
GO TO FULL VERSION