HTML 实体编码器 / 解码器

编码和解码 HTML 实体,以便在网页中安全显示

编码选项

所有编码和解码均在您的浏览器中本地完成。

深度指南

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

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

最后核实: 本指南的纯文本版

关键数字一览

仅特殊字符模式
五个字符
和号、小于号、大于号、双引号和单引号。
输出形式
命名、十进制或十六进制
全部字符的命名模式遇到本地表中没有的名称时,改用十进制引用。
解码行为
一次 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,检查 UTF-8 字节可用文本转十六进制。它们不能替代 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 有效性。

资料来源

  1. WHATWG — HTML named character references
  2. WHATWG — Character reference parsing
  3. W3C — XML predefined entities
  4. OWASP — Context-dependent output encoding

本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。

把这个工具嵌入你的网站

免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。