c#json转xml字符串格式：从踩坑到跑通的实操记录
你拿到一段JSON，想在C#里转成XML字符串发给下游系统，结果发现数组变成了重复节点、属性全跑到元素里、数字和字符串分不清。这篇教程不绕弯子，直接按操作顺序讲清楚怎么选库、怎么控制结构、出错时先查哪里。适合需要对接老系统、生成配置文件或做数据交换的开发者。
在线工具JSON转XML
先想清楚：你要的XML长什么样
动手写代码之前，先拿一段真实JSON在纸上画出目标XML的骨架。JSON里的对象通常对应XML元素，数组对应重复的同名元素，但键名里带空格或特殊字符时，直接当元素名会出问题，得提前决定用编码替换还是加前缀。另一个容易忽略的点是根节点：JSON可以没有根，XML必须有且只有一个根元素，所以你要么固定一个根名，要么从数据里挑一个字段当根。把这几件事定下来，后面选库和写映射才有依据，否则代码写完才发现结构不对，返工成本更高。
选库：内置方案和第三方方案怎么挑
C#里处理JSON和XML的内置类库已经够用，但直接手写转换逻辑容易在嵌套深的时候失控。比较省事的做法是先把JSON反序列化成可遍历的结构，再逐层拼XML。如果你不想自己写递归，可以用社区里成熟的转换库，它们通常提供一行调用的入口，但默认行为未必符合你的预期——比如数组的表示方式、空值怎么处理、数字是否保留类型信息。选库时重点看它有没有提供配置项来控制这些细节，而不是只看能不能跑通。对于结构固定的数据，自己写一个小的映射函数反而更可控。
分步操作：从JSON字符串到XML字符串
第一步，把JSON字符串解析成可操作的对象。用内置的JsonDocument或反序列化成字典/列表都行，关键是保留原始类型信息，别急着转成字符串。第二步，确定根元素名称，创建XmlDocument或XDocument的根节点。第三步，写一个递归方法，根据当前值的类型决定生成元素还是文本：对象类型遍历属性，数组类型对每个元素生成同名子节点，基本类型直接写文本。第四步，处理特殊键名，把不合法的XML字符替换掉，或者统一加一个前缀。第五步，输出字符串时选择带缩进还是紧凑格式，并确认编码声明符合接收方要求。如果不想自己写递归，可以在需要快速验证结构时用JSON转XML工具先看一眼目标格式，再回头调整代码。
常见错误与排查顺序
转换结果不对，先查三处。第一，数组是不是被当成了单个对象，导致只出现一个子节点；第二，空值字段是被跳过了还是生成了空元素，这两种行为下游系统可能只接受其中一种；第三，数字和布尔值有没有被加上引号变成字符串，XML本身不区分类型，但接收方解析时可能按预期类型校验。排查时不要盯着整个输出看，拿一段最小的JSON单独跑，逐层对比中间结构。另外，键名里出现冒号时容易被误认为命名空间前缀，需要显式转义或替换，否则生成的XML解析会报错。
进阶：让输出更稳定的小习惯
如果你的转换逻辑要长期维护，建议把映射规则抽成配置，而不是散落在递归函数里。比如哪些字段应该作为属性而不是元素，哪些数组需要包一层容器节点，这些差异用配置描述比改代码更安全。输出前统一做一次字符清洗，把控制字符和不合法的XML名称字符处理掉。还有一点，生成的XML字符串最好先经过一次解析验证，确认结构完整再交给下游，避免把问题带到联调阶段。对于需要反复转换的场景，把根节点命名和空值策略固定下来，能减少很多沟通成本。
总结
在C#里把JSON转成XML字符串，先确定目标XML的根节点和数组表示方式，再选择手写递归或借助库。操作时按解析JSON、建根节点、递归生成元素、处理特殊键名、输出字符串的顺序推进。遇到结构不对，优先检查数组层级、空值策略和类型引号。把映射规则固定下来并做输出验证，能减少联调时的反复。
相关文章
- 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后，为什么下游说少了一个层级？
默认转换往往把数组直接展开成重复的同名元素，但有些系统期望数组外面再包一个容器节点。你需要在递归逻辑里判断当前值是不是数组，如果是，先创建一个以字段名命名的容器元素，再把每个数组项作为子元素放进去。改完拿一段包含数组的样例单独验证。
Q2转换后的XML里，数字和布尔值都带上了引号，怎么避免？
XML文本本身不携带类型信息，带引号通常是因为你在拼接时统一调用了转字符串的方法。可以在递归时根据原始JSON值的类型决定是否加引号：数字和布尔直接写文本，字符串才需要处理转义。如果接收方要求严格类型，可以考虑在元素上加类型标注属性，而不是靠引号区分。
Q3键名里有冒号或空格，生成的XML解析报错怎么办？
冒号在XML里是命名空间分隔符，空格不允许出现在元素名中。最直接的办法是在生成元素名前做一次替换，把冒号换成下划线或短横线，把空格去掉或替换。替换规则要提前和接收方确认，避免两边理解不一致。也可以统一加一个前缀，但前缀本身也要符合XML命名规则。
Q4用内置类库手写递归和用第三方库，哪个更省事？
结构简单且字段固定时，手写递归逻辑更透明，出问题容易定位。结构嵌套深、字段多变时，第三方库能省去不少样板代码，但要花时间确认它的默认行为是否符合你的预期，尤其是数组和空值的处理。可以先用小样例对比两种方式的输出，再决定用哪个。