# XML 转 JSON 的映射规则：属性、重复元素与被丢弃的内容

> 本转换器使用的确切映射：属性用 @，与属性并存的文本用 #text，只有重复名称才变成数组，所有值都是字符串，混合内容的文本、注释和声明会被丢弃。

- Tool: [XML 转 JSON 转换器](https://toolsg.com/zh/xml-to-json)
- 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.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 属性 | 键带 @ 前缀（例如 "@id"） — 命名空间声明也是属性，所以 xmlns:ns 会显示为 "@xmlns:ns"。 |  |
| 与属性并存的文本 | 存放在键 "#text" 下 — 没有属性的叶子元素则直接变成普通字符串。 |  |
| 重复元素 | 只有同名出现多次才变成数组 — 一个 <item> 得到对象或字符串，两个则得到数组。 |  |
| 值的类型 | 始终是字符串 — 12.50 仍是 "12.50"；true 仍是 "true"。 |  |

## 转换如何工作

页面把你的文本（去掉首尾空白）以 `application/xml` 交给浏览器的 `DOMParser`。如果浏览器报告解析错误，你只会看到固定的提示“这不是格式良好的 XML。”；具体的行、列和原因不会显示。否则根元素成为唯一的顶层键，每个元素按以下规则变成 JSON 值（已在真实页面上核对）：

| XML | JSON |
| --- | --- |
| `<a><b>Mei</b></a>` | `{"a":{"b":"Mei"}}` |
| `<a/>` 或 `<a></a>` | `{"a":""}` |
| `<price currency="SGD">12.50</price>` | `{"price":{"#text":"12.50","@currency":"SGD"}}` |
| `<a x="1"/>` | `{"a":{"#text":"","@x":"1"}}` |
| `<a><b>1</b><b>2</b></a>` | `{"a":{"b":["1","2"]}}` |
| `<a><b>1</b></a>` | `{"a":{"b":"1"}}` |
| `<a><b>1</b><c>x</c><b>2</b></a>` | `{"a":{"b":["1","2"],"c":"x"}}` |
| `<ns:a xmlns:ns="urn:x" ns:id="5"/>` | 键 `"ns:a"`，带 `"@xmlns:ns"` 和 `"@ns:id"` |

输出用两个空格缩进。所有值都是字符串：转换器从不猜测数字或布尔值，所以 `12.50` 会保留末尾的零。

## 示例

```xml
<people><person id="1" active="true"><name>Mei</name></person><person id="2"><name>Ali</name></person></people>
```

```json
{
  "people": {
    "person": [
      { "@id": "1", "@active": "true", "name": "Mei" },
      { "@id": "2", "name": "Ali" }
    ]
  }
}
```

（页面会把每个对象展开成多行。）如果只有一个 `<person>`，同一路径下得到的是对象，而不是只有一项的数组。

## 会丢失什么

- **混合内容**：在 `<a>text<b>bold</b>more</a>` 中，只保留 `{"a":{"b":"bold"}}`；只要元素有子元素，文本节点 `text` 和 `more` 就会被丢弃。
- **既有子元素又有属性的元素，其文本** 同样被丢弃；只保留属性和子元素。
- **注释和处理指令** 被忽略，XML 声明也不会出现在结果中。
- **不同名称之间的顺序**：同级元素按名称分组，所以 `b, c, b` 变成 `b: [..], c`，穿插顺序无法恢复。
- **CDATA** 会并入普通文本：`<![CDATA[1 < 2 & 3]]>` 变成字符串 `1 < 2 & 3`。实体会被解码（`&amp;&lt;&#65;` 得到 `&<A`）。
- **空白**：子元素之间的缩进被忽略，但只含文本的元素会保留其空格，所以 `<a>  </a>` 得到 `"  "`。

## 错误与严格性

XML 比 HTML 严格得多。浏览器会拒绝：多个根元素（`<a/><b/>`）、标签不匹配（`<a><b>1</a>`）、属性值没加引号（`<a b=1/>`）、同一标签上的重复属性、以数字开头的名称（`<1/>`），以及 XML 规范没有定义的实体，例如 `&nbsp;`（只有 `amp`、`lt`、`gt`、`apos`、`quot` 是预定义的）。不是 XML 的纯文本也会被拒绝。输入为空时输出为空，不报错。

DOCTYPE 内部实体由浏览器解析器处理（测试中 `<!DOCTYPE a [<!ENTITY e "hi">]><a>&e;</a>` 得到 `"hi"`），所以含大量 DOCTYPE 的文档，结果取决于浏览器。不要粘贴带 DTD 的不可信 XML 并期待统一行为。

> **提示：** 因为一个子元素得到对象、多个子元素得到数组，使用这份 JSON 的代码必须同时处理两种形态。如果 XML 由你控制，使用一致的包装元素会让 JSON 更易用；否则请在代码中规范化（遇到非数组就包成数组）。

## 常见错误

- 把 `"@id"` 和 `"#text"` 当成数据本身。它们是本工具的约定；其他转换器可能用 `_attributes`、`$` 或 `attr_`。
- 期待得到数字或布尔值：所有值都是文本。
- 转换含多个顶层元素的 XML 片段；请先用一个根元素包起来。
- 以为可以无损往返。[JSON 转 XML](https://toolsg.com/zh/json-to-xml) 不写属性，所以 `@id` 会变成名为 `_id` 的元素。

## 相关工具

反方向用 [JSON 转 XML](https://toolsg.com/zh/json-to-xml)，用 [JSON 格式化](https://toolsg.com/zh/json-formatter)检查或重排结果，用 [JSON 查看器](https://toolsg.com/zh/json-viewer)浏览，或用 [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/) — Well-formedness rules, root element, attributes, predefined entities, mixed content.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — The JSON output.
- [MDN — DOMParser](https://developer.mozilla.org/en-US/docs/Web/API/DOMParser) — The browser parser the converter relies on.
