# JSON 转 XML：元素名、数组，以及转换器无法表达的内容

> 本转换器的确切规则：固定的 <root>、数组变成 <item>、null 变成空标签、不生成属性、键名清理及其冲突，以及控制字符方面的一个已知缺口。

- Tool: [JSON 转 XML 转换器](https://toolsg.com/zh/json-to-xml)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-19
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 根元素 | 始终是 <root> — 不能改名，也不会写出 XML 声明。 |  |
| 数组项 | 每一项都变成 <item> — 数组自己的键成为外层包装元素。 |  |
| 属性 | 从不生成 — 每个 JSON 成员都变成子元素，所以无法生成 XML 属性。 |  |
| 转义字符 | 文本中的 & < > " — 撇号保持原样；在元素文本中不需要转义。 |  |

## 映射规则

粘贴 JSON 后，右侧框显示缩进后的 XML（每级两个空格）。不会上传任何内容。以下规则取自转换器代码，并用示例输入运行验证：

| JSON | XML |
| --- | --- |
| 对象 `{"a":1}` | `<root><a>1</a></root>`（子元素分行缩进） |
| 数组 `[1,2]` | `<root><item>1</item><item>2</item></root>` |
| 键 `tags` 下的嵌套数组 | `<tags><item>a</item><item>b</item></tags>` |
| `null` | 自闭合 `<none/>` |
| `{}`（空对象） | 自闭合 `<obj/>` |
| `[]`（空数组） | 内容为一个空行的元素 |
| `""`（空字符串） | `<s></s>` |
| `true`、`1.50` | `<t>true</t>`、`<n>1.5</n>`（数字按 JavaScript 方式输出） |
| 单个值 `5` | `<root>5</root>` |
| 顶层的 `null` | `<root/>` |

示例：`[{"name":"Mei","city":"Singapore","age":30},{"name":"Ali","city":"Johor","age":25}]` 变成

```xml
<root>
  <item>
    <name>Mei</name>
    <city>Singapore</city>
    <age>30</age>
  </item>
  <item>
    <name>Ali</name>
    <city>Johor</city>
    <age>25</age>
  </item>
</root>
```

不会写出 `<?xml ... ?>` 声明，页面也不指定编码；如果使用方需要声明，请复制或下载（`converted.xml`）文本后自行添加。

## 元素名会被清理

XML 名称比 JSON 键更严格：不能以数字开头，也不能含空格。转换器把 `A–Z a–z 0–9 _ . -` 之外的每个字符替换成 `_`，如果结果不是以字母或下划线开头，就在前面加 `_`：

| JSON 键 | 元素 |
| --- | --- |
| `first name` | `<first_name>` |
| `1st` | `<_1st>` |
| `@id`、`#text` | `<_id>`、`<_text>` |
| `a:b` | `<a_b>` |
| `x.y-z` | `<x.y-z>`（不变） |
| `名字` | `<__>`（非 ASCII 字母被替换，尽管 XML 允许许多这类字符） |
| 空键 `""` | `<_>` |

有两点后果值得注意。不同的键可能冲突：`a b`、`a:b` 和 `a_b` 都变成 `<a_b>`，XML 并不禁止重复元素，所以数据不会丢，但区别没了。其次，用非拉丁文字书写的键会变成下划线，这类文档的 XML 就没法读了。如果你的数据用了这类键，请先改名再转换。

## 文本会转义，但不做验证

值中的 `&`、`<`、`>` 和 `"` 会变成 `&amp;`、`&lt;`、`&gt;` 和 `&quot;`，所以 `Mei & Co <x>` 是安全的。字符串里的换行和制表符会原样复制。有一个缺口：除制表符、换行和回车之外的控制字符会被原样复制，但 XML 1.0 禁止它们（合法字符从 U+0020 起，另加制表符、换行和回车），因此像 `"\u0001"` 这样的 JSON 字符串会产生 XML 解析器拒绝的输出。请事先去掉这类字符。

## 无法表达的内容

- **属性**：一切都变成元素。要得到 `<person id="1">`，请用别的方法构建 XML。
- **往返**：JSON → XML → JSON 会把每个数组变成重复的 `item` 子元素，把每个标量变成字符串。[XML 转 JSON](https://toolsg.com/zh/xml-to-json) 把属性读成 `@name`，但本转换器把 `@name` 写成 `<_name>`。
- **类型**：`5`、`"5"` 和 `true` 都显示为纯文本。使用方需要模式（schema）才能分辨。
- **固定的根**：如果目标要求特定的文档元素，请在输出中改掉 `<root>`。
- **混合内容** 在这里没有对应的 JSON 形式。

> **提示：** 做数据交换时，先把值包在只有一个键的对象里，例如 `{"orders":[…]}`；结果是 `<root><orders><item>…`，比裸的 `<root><item>` 更接近大多数 XML 模式的预期。

## 常见错误

- 期待属性或自定义根名。
- 使用含空格或标点的键，却没发现它们被改写了。
- 把输出粘贴到要求 XML 声明或模式的系统。
- 以为空数组会得到空标签；实际得到的是里面带一个空行的元素。

## 相关工具

用 [XML 转 JSON](https://toolsg.com/zh/xml-to-json)转换回去，用 [JSON 验证器](https://toolsg.com/zh/json-validator)检查源数据，用 [JSON 转文本](https://toolsg.com/zh/json-to-text)查看路径，或用 [JSON 转 CSV](https://toolsg.com/zh/json-to-csv)生成表格。

## 常见问题

**我的数据会被上传吗？**

不会。转换完全在您的浏览器中通过 JavaScript 运行。您粘贴的内容不会离开您的设备，不会被记录，也不会存储在服务器上。

**可以处理多大的文档？**

限制取决于您浏览器的内存，而非服务器配额。几兆字节的文档可以顺利转换；极大的文件可能会让页面在处理时短暂无响应。

**嵌套数据会怎样处理？**

对于没有嵌套概念的格式，嵌套值会以 JSON 字符串的形式存入单元格，因此不会有内容被悄悄丢弃，结构也可以还原。

**能正确处理字段中的引号和逗号吗？**

可以。解析遵循 RFC 4180，因此包含逗号的带引号字段、转义的双引号，以及字段内部的换行都能被正确读写。


## 资料来源

- [W3C — Extensible Markup Language (XML) 1.0, Fifth Edition](https://www.w3.org/TR/xml/) — Names (section 2.3), legal characters (section 2.2), escaping and well-formedness.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — The JSON input.
