在C#开发中，处理XML文件时解析修改后保存出现格式错乱、编码不一致是常见问题，比如中文乱码、缩进丢失、XML声明信息错误等，这些问题大多和解析、修改、保存环节的API使用方式有关。
常见格式与编码问题成因
首先我们需要了解问题出现的核心原因，才能针对性解决：
- 解析时未指定正确的编码读取，导致原文件编码被错误识别，修改后保存自然出现乱码
- 修改过程中直接拼接字符串生成XML，破坏了原有的缩进、换行等格式结构
- 保存时未配置
XmlWriterSettings参数，导致输出没有缩进、缺少XML声明或者编码设置错误 - 加载XML时使用
LoadXml方法但未处理声明信息，导致原有编码声明丢失
正确的解析与修改流程
推荐使用XmlDocument或者XDocument类处理XML，这两类API可以完整保留原文件的结构和声明信息，避免手动拼接字符串带来的问题。
使用XmlDocument解析修改
以下是使用XmlDocument加载XML并修改节点的示例，该方式可以完整保留原文件的编码和格式信息：
using System;
using System.Xml;
class Program
{
static void Main()
{
// 创建XmlDocument实例
XmlDocument xmlDoc = new XmlDocument();
// 加载XML文件，会自动识别文件的编码信息
xmlDoc.Load("test.xml");
// 获取需要修改的节点，这里以修改根节点下的name子节点为例
XmlNode nameNode = xmlDoc.SelectSingleNode("/root/name");
if (nameNode != null)
{
nameNode.InnerText = "新的名称";
}
// 保存修改后的文件，后续会讲解保存时的编码和格式配置
xmlDoc.Save("test_modified.xml");
}
}
使用XDocument解析修改
XDocument是LINQ to XML的核心类，语法更简洁，同样可以保留原文件信息：
using System;
using System.Xml.Linq;
class Program
{
static void Main()
{
// 加载XML文件，自动识别编码
XDocument xDoc = XDocument.Load("test.xml");
// 修改对应节点内容
XElement nameElement = xDoc.Root.Element("name");
if (nameElement != null)
{
nameElement.Value = "新的名称";
}
// 保存文件
xDoc.Save("test_modified.xml");
}
}
保存时确保格式与编码正确
保存环节是控制格式和编码的关键，需要配置对应的参数保证输出符合要求。
使用XmlDocument保存的配置
如果使用XmlDocument，可以通过XmlWriter和XmlWriterSettings来配置保存参数：
using System;
using System.Xml;
class Program
{
static void Main()
{
XmlDocument xmlDoc = new XmlDocument();
xmlDoc.Load("test.xml");
// 修改节点
XmlNode nameNode = xmlDoc.SelectSingleNode("/root/name");
if (nameNode != null)
{
nameNode.InnerText = "新的名称";
}
// 配置保存参数
XmlWriterSettings settings = new XmlWriterSettings();
// 开启缩进，保证格式美观
settings.Indent = true;
// 缩进使用的字符串，默认是空格
settings.IndentChars = " ";
// 保留XML声明，默认是保留的，这里显式设置更清晰
settings.OmitXmlDeclaration = false;
// 编码设置为UTF-8，如果需要和原文件一致，可以读取原文件的编码后设置
settings.Encoding = System.Text.Encoding.UTF8;
// 使用XmlWriter保存
using (XmlWriter writer = XmlWriter.Create("test_modified.xml", settings))
{
xmlDoc.Save(writer);
}
}
}
使用XDocument保存的配置
XDocument的Save方法也支持传入XmlWriter来配置参数：
using System;
using System.Xml;
using System.Xml.Linq;
class Program
{
static void Main()
{
XDocument xDoc = XDocument.Load("test.xml");
XElement nameElement = xDoc.Root.Element("name");
if (nameElement != null)
{
nameElement.Value = "新的名称";
}
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.Encoding = System.Text.Encoding.UTF8;
settings.OmitXmlDeclaration = false;
using (XmlWriter writer = XmlWriter.Create("test_modified.xml", settings))
{
xDoc.Save(writer);
}
}
}
编码一致性处理技巧
如果需要保证保存后的文件编码和原文件完全一致，不要硬编码编码参数，而是先读取原文件的编码信息：
using System;
using System.IO;
using System.Text;
using System.Xml;
using System.Xml.Linq;
class Program
{
static void Main()
{
string filePath = "test.xml";
// 读取原文件的编码
Encoding originalEncoding;
using (StreamReader reader = new StreamReader(filePath, true))
{
originalEncoding = reader.CurrentEncoding;
}
XDocument xDoc = XDocument.Load(filePath);
XElement nameElement = xDoc.Root.Element("name");
if (nameElement != null)
{
nameElement.Value = "新的名称";
}
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.Encoding = originalEncoding;
settings.OmitXmlDeclaration = false;
using (XmlWriter writer = XmlWriter.Create("test_modified.xml", settings))
{
xDoc.Save(writer);
}
}
}
注意事项总结
- 不要使用字符串拼接的方式生成XML内容，尽量使用官方提供的XML API操作节点
- 加载XML时优先使用
Load方法而不是LoadXml，前者会自动处理编码和声明信息 - 保存时务必配置
XmlWriterSettings的Indent参数为true，保证格式缩进正确 - 编码设置优先读取原文件的编码，避免硬编码导致编码不一致
- 如果原XML文件有自定义的声明信息，比如
<?xml version="1.0" encoding="GBK"?>，保存时OmitXmlDeclaration要设为false，否则声明会丢失
处理XML文件时，尽量使用成熟的XML解析API而不是手动处理字符串，既可以保证格式和编码正确，也能避免XML语法错误导致解析失败的问题。