XStream 序列化時下劃線轉雙下劃線問題的解決方案

XStream 下劃線轉義問題分析與修復

XStream 將 Java 對象序列化為 XML 時，會將屬性名中的單下劃線 _ 轉換為雙下劃線 __。許多開發者誤以為是 Bug，實則是 XStream 默認的命名編碼策略導致。

一、源碼追蹤

查看源碼可見，XStream 內部使用 XmlFriendlyNameCoder 對名稱進行編碼，將 _ 替換為 __ 以避免 XML 命名衝突。

二、解決方案：使用 NoNameCoder

實例化 XStream 時傳入 NoNameCoder，禁用默認編碼，保持屬性名原樣輸出。

public static void main(String[] args) {
    XStream xs = new XStream(new Xpp3Driver(new NoNameCoder()));
    Bean b = new Bean();
    System.out.println(xs.toXML(b));
}

三、效果對比

• 默認編碼：<user_name> → <user__name>
• 使用 NoNameCoder：<user_name> 保持不變

此方案簡潔高效，適用於所有屬性名包含下劃線的場景。