使用Newtonsoft.Json和XmlDocument可高效转换XML到JSON,需注意混合内容处理、类型推断、数组生成及命名空间问题,通过忽略空节点、手动类型转换和结构预处理解决常见错误,结合性能优化策略提升处理效率。

在C#开发中,将XML转换为JSON是常见需求,尤其是在处理Web API、配置文件或跨平台数据交换时。虽然.NET提供了多种工具来实现这一功能,但在实际使用中容易遇到格式不一致、命名冲突、类型丢失等问题。以下是高效解析并转换XML到JSON的方法,以及常见错误与对应解决方案。
1. 使用 Newtonsoft.Json 进行 XML 到 JSON 转换
最常用且稳定的方式是结合 System.Xml 和 Newtonsoft.Json(也称 Json.NET)库。通过 XmlDocument 读取XML,再利用 JsonConvert.SerializeXmlNode() 实现转换。
示例代码:
using System.Xml; using Newtonsoft.Json; string xml = @""; XmlDocument doc = new XmlDocument(); doc.LoadXml(xml); string json = JsonConvert.SerializeXmlNode(doc, Newtonsoft.Json.Formatting.Indented); Console.WriteLine(json); 张三 30 false
输出结果为标准JSON格式:
{
"person": {
"name": "张三",
"age": "30",
"isStudent": false
}
}
该方法简洁高效,支持嵌套结构和属性处理。
2. 常见错误与解决方案
错误1:文本节点与元素混淆导致JSON结构异常
当XML包含混合内容(如文本与子元素共存),默认转换可能生成不符合预期的JSON。
问题XML示例:
这是一个 红色 的苹果
直接转换后可能产生 #text 字段,影响可读性。
解决方案:
- 使用 SerializeXmlNode(doc, Formatting.None, true) 的第三个参数设置为 true,忽略空节点和文本包装。
- 若需精细控制,先预处理XML,拆分混合内容或使用LINQ to XML重构结构。
错误2:数字或布尔值被序列化为字符串
XML本身无类型概念,所有值均为字符串。默认转换下, 会变成 "age": "30",而非数值。
解决方案:
- 启用 WriteArrayAttribute 并配合类型推断机制。
- 更有效方式是在反序列化前手动处理节点,或使用自定义转换逻辑。
- 推荐做法:在目标系统接收JSON后做类型转换,或在C#端使用JObject后遍历修正类型。
示例:自动识别基本类型
JObject jObj = JObject.Parse(json);
foreach (var prop in jObj["person"].Children())
{
if (prop is JProperty p)
{
if (int.TryParse(p.Value?.ToString(), out int i))
p.Value = i;
else if (bool.TryParse(p.Value?.ToString(), out bool b))
p.Value = b;
}
}
错误3:根节点缺失或重复导致数组处理失败
多个同名元素应转为JSON数组,但若未正确包裹,会丢失结构。
错误XML:
- A
- B
期望输出:"item": ["A", "B"]
解决方案:
- 确保XML结构合理,多个子项应在同一父级下。
- 使用 XmlDocument + JsonConvert 可自动识别重复子元素并转为数组。
- 避免使用无根节点的XML片段;如有必要,手动添加临时根节点。
错误4:XML声明或命名空间引起解析异常
带有 或命名空间(xmlns)的文档可能导致加载失败或字段带前缀。
解决方案:
- 使用 XmlDocument.LoadXml() 支持完整XML声明。
- 处理命名空间时,可用 XmlNamespaceManager 忽略或映射前缀。
- 如无需保留命名空间,读取前用正则替换移除 xmlns 属性(谨慎使用)。
性能优化建议
- 对大批量XML转换,考虑使用 XDocument 替代 XmlDocument,内存占用更低。
- 缓存重复使用的转换逻辑,避免频繁创建对象。
- 异步处理大文件:读取文件时使用 async/await 防止阻塞主线程。
- 优先使用 JsonSerializerSettings 统一配置,如日期格式、缩进等。
基本上就这些。只要注意结构规范、类型处理和边界情况,C#中的XML到JSON转换可以既高效又可靠。关键是选择合适的工具链并提前处理典型陷阱。










