# HTML 实体：编码范围、解码与使用上下文

> 选择命名、十进制或十六进制引用，了解特殊字符模式、单次解码、Unicode 限制与 XML 差异。

- Tool: [HTML实体编码器 / 解码器](https://toolsg.com/zh/html-entity-encoder)
- 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.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 仅特殊字符模式 | 五个字符 — 和号、小于号、大于号、双引号和单引号。 |  |
| 输出形式 | 命名、十进制或十六进制 — 全部字符的命名模式遇到本地表中没有的名称时，改用十进制引用。 |  |
| 解码行为 | 一次 HTML 解析 — 浏览器解码引用，不验证或净化输入。 |  |
| 显示长度 | UTF-16 代码单元 — 🙂 这样的表情计作两个单元，不是一个可见符号。 |  |

## 选择模式并转换

粘贴文本，选择引用类型及“仅特殊字符”或“全部字符”，再按编码。解码使用浏览器的 HTML 引用解析器，不受编码范围单选按钮影响。交换会互换输入和输出，复制使用结果。

仅特殊字符模式处理上述五个保留字符。全部字符模式按 Unicode 码点遍历；命名形式先查小型内置映射表，其余字符用十进制引用，不会搜索完整 HTML 命名引用表。

## 真实页面示例

| 输入 | 编码选择 | 结果 |
| --- | --- | --- |
| `<>&` | 仅特殊字符，命名 | `&lt;&gt;&amp;` |
| `🙂` | 全部，十进制 | `&#128578;` |
| `🙂` | 全部，十六进制 | `&#x1F642;` |
| `©A` | 全部，命名 | `&copy;&#65;` |
| `A B` | 全部，命名 | `&#65;&#32;&#66;` |

普通空格在全部字符的命名模式中变为 `&#32;`；U+00A0 不换行空格则变为 `&nbsp;`。它们是不同字符。编码器将表情作为一个码点处理，长度统计则计为两个 UTF-16 单元。

## 解码与重复编码

解码 `&amp;lt;` 得到的是引用文本 `&lt;`，不会在同一次处理中继续变成小于号。已有 `&lt;` 再编码会变成 `&amp;lt;`。应先确认目标需要哪一层编码，避免反复按按钮。

解码不会剥除标签：输入 `<b>A</b>` 在输出框中仍是这段文本。无效引用按浏览器 HTML 解析规则处理，本工具不是严格验证器。有些数值无法原样往返，例如空字符引用会变成替代字符。

## 上下文、XML 与限制

HTML 文本、带引号属性、URL、JavaScript 和 CSS 是不同输出上下文。本工具转换引用，不会自动选择适合上下文的转义方式，也不会净化任意标记。请使用框架针对目标位置提供的输出机制。

HTML 与 XML 的实体集合不同。XML 只预定义 `amp`、`lt`、`gt`、`quot` 和 `apos`；`nbsp`、`copy` 等名称需要声明。数字引用语法本身不保证该值是有效 XML 字符。XML 文档应采用了解 XML 规则的转义及验证方法。

转换在浏览器本地进行，不会为处理上传文本。空输入或仅含空白的输入会被拒绝。显示的引用数量只是文本模式计数，不证明每一项有效。下载生成 `.html` 文件；扩展名不证明内容可安全渲染。

字节转文本可用 [Base64](https://toolsg.com/zh/base64-encoder)，检查 UTF-8 字节可用[文本转十六进制](https://toolsg.com/zh/text-to-hex)。它们不能替代 HTML 转义。

## 常见问题

**什么是 HTML 实体？**

HTML 实体是以 & 开头、以 ; 结尾的特殊代码，用于在 HTML 中显示保留字符或特殊字符。例如，&lt; 显示为 <，&amp; 显示为 &。它们防止浏览器将字符解释为 HTML 代码。

**什么时候应该使用 HTML 实体编码？**

目标 HTML 文本上下文需要时可使用实体编码。属性值、URL、JavaScript 和 CSS 各有不同规则；本工具不会选择正确上下文，也不会净化标记。

**命名实体和数字实体有什么区别？**

命名引用用名称表示字符，十进制和十六进制引用使用 Unicode 码点数值。数字语法不保证每个值都有效或原样还原：HTML 对无效值和部分旧控制值有专门规则。

**我的文本数据会被发送到任何服务器吗？**

不会，所有 HTML 实体编码和解码完全在您的浏览器中进行。您的数据永远不会离开您的设备，这使得该工具对敏感 HTML 代码和内容完全安全。

**我应该编码所有字符还是仅编码特殊字符？**

通常，仅编码特殊字符（< > & " '）以保持文件大小较小且 HTML 源代码可读。编码所有字符会显著增加文件大小，只在特定情况下（如防止文本注入攻击）才需要。

**我可以解码 HTML 中已有的实体吗？**

可以，解码功能将 HTML 实体转换回其原始字符。这对于阅读编码内容、编辑或在不同编码格式之间转换非常有用。

**如果我对文本编码两次会发生什么？**

双重编码会对实体本身进行编码。例如，再次编码 &lt; 会产生 &amp;lt;，在浏览器中显示为 &lt; 而不是 <。在再次编码之前，始终检查文本是否已经编码。

**我应该使用哪种实体类型？**

命名实体最易读，推荐用于常见字符。对于没有命名等价物的字符，使用数字实体。十六进制实体受到处理 Unicode 码点的开发人员的青睐。所有三种类型在现代浏览器中都能正常工作。

**HTML 实体编码能防止 XSS 攻击吗？**

实体编码是依赖上下文的输出编码，不是 XSS 净化器。它不会让任意 URL、JavaScript、CSS 或标记变安全。请使用目标上下文要求的转义或净化机制。

**我可以将此工具用于 XML 文档吗？**

HTML 与 XML 的实体集合不同。XML 只预定义 amp、lt、gt、quot 和 apos；nbsp、copy 等名称需要另行声明。应使用了解 XML 规则的转义方法，并验证结果及 XML 字符限制。

**HTML 编码和 URL 编码有什么区别？**

HTML 编码使用实体（如 &lt;）在 HTML 文档中显示。URL 编码使用百分号编码（如 %3C）用于网址。它们的用途不同：HTML 编码用于内容显示，URL 编码用于在 URL 中传输数据。

**有哪些字符无法编码吗？**

不是每个 Unicode 值都能通过 HTML 引用原样往返。例如空字符引用会变成替代字符，无效值由解析器规则处理。本工具转换 HTML 文本，不检查 Unicode 或 XML 有效性。


## 资料来源

- [WHATWG — HTML named character references](https://html.spec.whatwg.org/multipage/named-characters.html)
- [WHATWG — Character reference parsing](https://html.spec.whatwg.org/multipage/parsing.html#character-reference-state)
- [W3C — XML predefined entities](https://www.w3.org/TR/xml/#sec-predefined-ent)
- [OWASP — Context-dependent output encoding](https://cheatsheetseries.owasp.org/cheatsheets/Cross_Site_Scripting_Prevention_Cheat_Sheet.html)
