c#json转xml：从解析到生成的实战教程
在C#项目里，有时需要把接口返回的JSON数据转换成XML格式，比如对接旧系统、生成配置文件或满足特定协议要求。这篇教程面向已经熟悉C#基础语法的开发者，从准备工作开始，一步步演示如何用Newtonsoft.Json解析JSON，再用System.Xml.Linq生成XML，并给出常见错误的排查思路。
在线工具JSON转XML
动手之前：理清JSON与XML的结构差异
JSON和XML描述数据的方式不同，直接转换容易踩坑。JSON有对象、数组和基本类型，XML则靠元素和属性表达层次。转换前先想清楚：JSON里的数组对应XML中重复的元素，还是带索引的子元素？JSON的键名可能包含空格或特殊字符，XML元素名必须合法。另外，JSON的值类型（数字、布尔、null）在XML里通常以文本形式保存，需要约定好类型标记或直接转成字符串。
如果项目里还没有现成的转换逻辑，可以先用一个简单的JSON样本手动写出目标XML的样子，再决定代码怎么写。对于需要深入理解转换原理的读者，可以参考这篇关于JSON转XML转换工具原理的文章，它解释了映射规则和常见陷阱。
准备环境：引入必要的库
在C#中处理JSON，常用的是Newtonsoft.Json库；生成XML则可以用内置的System.Xml.Linq。如果项目还没有引用Newtonsoft.Json，可以通过NuGet包管理器安装。在代码文件顶部添加using Newtonsoft.Json.Linq;和using System.Xml.Linq;。
这一步的关键是确认库的版本与项目目标框架兼容。如果团队规定不使用第三方库，也可以考虑System.Text.Json，但它的JToken模型与Newtonsoft.Json不同，后续代码需要调整。本文以Newtonsoft.Json为例，因为它的JToken遍历方式对转换比较直观。
分步操作：解析JSON并构建XML
第一步，把JSON字符串解析成JToken。用JToken.Parse(jsonString)得到根节点，如果JSON来自文件，可以用JToken.ReadFrom(new JsonTextReader(reader))。解析后先检查根节点的类型（JObject、JArray或JValue），因为不同类型的处理方式不同。
第二步，创建一个XElement作为XML根元素，元素名可以自定义，比如<root>。然后写一个递归方法，把JToken转换成XElement。核心逻辑是：遇到JObject，为每个属性创建一个子元素，属性名作为元素名（必要时做名称合法化处理），属性值递归处理；遇到JArray，为每个元素创建一个统一命名的子元素（比如<item>），再递归处理数组项；遇到JValue，直接创建包含文本值的元素。
第三步，把生成的XElement保存为XML字符串或文件。用xElement.ToString()得到带缩进的字符串，用xElement.Save(filePath)写入文件。如果希望XML声明包含编码信息，可以在保存时指定编码。
如果不想写代码，也可以先用在线工具快速验证转换结果，比如本站的JSON转XML工具，把JSON粘贴进去就能看到对应的XML结构，方便对照检查。
常见错误与排查思路
转换过程中容易遇到几类问题。一是元素名不合法：JSON的键可能以数字开头或包含空格，直接用作XML元素名会抛异常。解决办法是在生成元素名前做替换或添加前缀，比如把空格换成下划线，数字开头时加一个字母前缀。二是数组处理不统一：有的JSON数组元素是对象，有的是字符串，递归方法要能处理混合类型，否则会漏掉数据。三是null值处理：JSON中的null在XML里可以表示为空元素或带xsi:nil属性的元素，需要根据下游系统要求决定。四是编码问题：如果XML要包含中文，保存时确保使用UTF-8编码，并在XML声明中体现。
排查时建议先用小样本测试，逐步增加嵌套层级，观察每一步生成的XElement结构是否符合预期。对于更复杂的转换场景，比如从阿里云JSON到XML的实践，可以参考相关转换实践文章中的处理方式。
进阶技巧：自定义映射与类型保留
当JSON结构比较固定时，可以定义一套映射规则，把特定的JSON路径映射到指定的XML元素名或属性。例如，把JSON中的"id"字段映射为XML元素的id属性，而不是子元素。这需要在递归方法中增加一个配置字典，根据路径决定输出形式。
另一个技巧是保留数据类型信息。可以在XML元素上添加type属性，标记原始JSON值的类型（string、number、boolean等），方便反向转换时还原。如果项目需要双向转换，建议同时实现XML转JSON的逻辑，本站的XML转JSON工具可以用来验证反向结果是否一致。
对于大型JSON，递归深度可能很大，要注意栈溢出的风险，可以考虑改用迭代方式遍历。另外，如果JSON中包含循环引用（虽然标准JSON不支持，但某些序列化库可能产生），解析时会报错，需要在解析前处理。
总结
在C#中完成JSON转XML，核心步骤是：引入Newtonsoft.Json和System.Xml.Linq，解析JSON为JToken，递归构建XElement并处理对象、数组和值类型，最后保存为XML。注意元素名合法化、数组元素命名和null值处理，遇到错误时用小样本逐步排查。
相关文章
- cjson转xml字符串怎么做才不踩坑
从字段类型、数组表示到根节点约定，说明把 cJSON 数据转成 XML 字符串时容易出错的地方，并给出可操作的检查思路。
- cjson转xmlcdata：CDATA在数据转换中的角色
探讨cjson转xmlcdata时CDATA的用途与处理方式，帮助开发者在JSON与XML转换中正确处理特殊字符和富文本内容。
- cjson转xml：从JSON结构到XML文档的映射思路
聊聊cjson转xml时字段名、数组、属性与命名空间的对应方式，以及转换后校验结构完整性的思路。
- cjson转cdataxml：处理特殊字符的转换思路
当JSON数据需要嵌入XML时，cjson转cdataxml能避免特殊字符冲突。本文解释其含义、适用场景与操作要点。
- cjson文件转xml文件怎么打开？先理清转换与打开的关系
遇到cjson文件转xml文件怎么打开的问题？本文教你识别cjson文件、选择转换方式、用合适工具查看XML结果，并排查常见错误。
常见问题
Q1JSON中的数组转换成XML时，元素名应该怎么定？
常见做法是为数组统一使用一个元素名，比如<item>，每个数组项对应一个<item>元素。如果数组项本身是对象，就在<item>内部继续展开属性。元素名可以根据业务含义自定义，但要在整个文档中保持一致，方便下游解析。
Q2转换后XML里的数字和布尔值都变成了字符串，怎么保留类型？
XML本身不强制类型，所有文本都是字符串。如果需要保留类型，可以在元素上添加自定义属性，比如type="number"，或者在约定好的模式下由下游系统根据字段名推断。也可以在生成XML时把值包装成带类型标记的子元素。
Q3JSON键名包含特殊字符导致生成XML时报错，如何处理？
XML元素名必须符合命名规范，不能以数字开头，不能包含空格和某些符号。可以在生成元素名前对键名进行清洗：把非法字符替换为下划线，如果以数字开头则添加前缀字母。清洗规则要记录在文档中，保证转换前后可追溯。
Q4用Newtonsoft.Json解析时遇到“Unexpected character”错误怎么办？
这通常说明JSON字符串格式不正确，比如有多余的逗号、缺少引号或包含注释。可以先用在线JSON校验工具检查原始字符串，或者用JToken.Parse时捕获JsonReaderException，输出错误位置附近的字符来定位问题。