HTML 实体编码器 / 解码器
编码和解码 HTML 实体,以便在网页中安全显示
编码选项
所有编码和解码均在您的浏览器中本地完成。
深度指南
HTML 实体:编码范围、解码与使用上下文
选择命名、十进制或十六进制引用,了解特殊字符模式、单次解码、Unicode 限制与 XML 差异。
关键数字一览
- 仅特殊字符模式
- 五个字符
- 和号、小于号、大于号、双引号和单引号。
- 输出形式
- 命名、十进制或十六进制
- 全部字符的命名模式遇到本地表中没有的名称时,改用十进制引用。
- 解码行为
- 一次 HTML 解析
- 浏览器解码引用,不验证或净化输入。
- 显示长度
- UTF-16 代码单元
- 🙂 这样的表情计作两个单元,不是一个可见符号。
选择模式并转换
粘贴文本,选择引用类型及“仅特殊字符”或“全部字符”,再按编码。解码使用浏览器的 HTML 引用解析器,不受编码范围单选按钮影响。交换会互换输入和输出,复制使用结果。
仅特殊字符模式处理上述五个保留字符。全部字符模式按 Unicode 码点遍历;命名形式先查小型内置映射表,其余字符用十进制引用,不会搜索完整 HTML 命名引用表。
真实页面示例
| 输入 | 编码选择 | 结果 |
|---|---|---|
<>& |
仅特殊字符,命名 | <>& |
🙂 |
全部,十进制 | 🙂 |
🙂 |
全部,十六进制 | 🙂 |
©A |
全部,命名 | ©A |
A B |
全部,命名 | A B |
普通空格在全部字符的命名模式中变为  ;U+00A0 不换行空格则变为 。它们是不同字符。编码器将表情作为一个码点处理,长度统计则计为两个 UTF-16 单元。
解码与重复编码
解码 &lt; 得到的是引用文本 <,不会在同一次处理中继续变成小于号。已有 < 再编码会变成 &lt;。应先确认目标需要哪一层编码,避免反复按按钮。
解码不会剥除标签:输入 <b>A</b> 在输出框中仍是这段文本。无效引用按浏览器 HTML 解析规则处理,本工具不是严格验证器。有些数值无法原样往返,例如空字符引用会变成替代字符。
上下文、XML 与限制
HTML 文本、带引号属性、URL、JavaScript 和 CSS 是不同输出上下文。本工具转换引用,不会自动选择适合上下文的转义方式,也不会净化任意标记。请使用框架针对目标位置提供的输出机制。
HTML 与 XML 的实体集合不同。XML 只预定义 amp、lt、gt、quot 和 apos;nbsp、copy 等名称需要声明。数字引用语法本身不保证该值是有效 XML 字符。XML 文档应采用了解 XML 规则的转义及验证方法。
转换在浏览器本地进行,不会为处理上传文本。空输入或仅含空白的输入会被拒绝。显示的引用数量只是文本模式计数,不证明每一项有效。下载生成 .html 文件;扩展名不证明内容可安全渲染。
常见问题
什么是 HTML 实体?
HTML 实体是以 & 开头、以 ; 结尾的特殊代码,用于在 HTML 中显示保留字符或特殊字符。例如,< 显示为 <,& 显示为 &。它们防止浏览器将字符解释为 HTML 代码。
什么时候应该使用 HTML 实体编码?
目标 HTML 文本上下文需要时可使用实体编码。属性值、URL、JavaScript 和 CSS 各有不同规则;本工具不会选择正确上下文,也不会净化标记。
命名实体和数字实体有什么区别?
命名引用用名称表示字符,十进制和十六进制引用使用 Unicode 码点数值。数字语法不保证每个值都有效或原样还原:HTML 对无效值和部分旧控制值有专门规则。
我的文本数据会被发送到任何服务器吗?
不会,所有 HTML 实体编码和解码完全在您的浏览器中进行。您的数据永远不会离开您的设备,这使得该工具对敏感 HTML 代码和内容完全安全。
我应该编码所有字符还是仅编码特殊字符?
通常,仅编码特殊字符(< > & " ')以保持文件大小较小且 HTML 源代码可读。编码所有字符会显著增加文件大小,只在特定情况下(如防止文本注入攻击)才需要。
我可以解码 HTML 中已有的实体吗?
可以,解码功能将 HTML 实体转换回其原始字符。这对于阅读编码内容、编辑或在不同编码格式之间转换非常有用。
如果我对文本编码两次会发生什么?
双重编码会对实体本身进行编码。例如,再次编码 < 会产生 &lt;,在浏览器中显示为 < 而不是 <。在再次编码之前,始终检查文本是否已经编码。
我应该使用哪种实体类型?
命名实体最易读,推荐用于常见字符。对于没有命名等价物的字符,使用数字实体。十六进制实体受到处理 Unicode 码点的开发人员的青睐。所有三种类型在现代浏览器中都能正常工作。
HTML 实体编码能防止 XSS 攻击吗?
实体编码是依赖上下文的输出编码,不是 XSS 净化器。它不会让任意 URL、JavaScript、CSS 或标记变安全。请使用目标上下文要求的转义或净化机制。
我可以将此工具用于 XML 文档吗?
HTML 与 XML 的实体集合不同。XML 只预定义 amp、lt、gt、quot 和 apos;nbsp、copy 等名称需要另行声明。应使用了解 XML 规则的转义方法,并验证结果及 XML 字符限制。
HTML 编码和 URL 编码有什么区别?
HTML 编码使用实体(如 <)在 HTML 文档中显示。URL 编码使用百分号编码(如 %3C)用于网址。它们的用途不同:HTML 编码用于内容显示,URL 编码用于在 URL 中传输数据。
有哪些字符无法编码吗?
不是每个 Unicode 值都能通过 HTML 引用原样往返。例如空字符引用会变成替代字符,无效值由解析器规则处理。本工具转换 HTML 文本,不检查 Unicode 或 XML 有效性。
资料来源
- WHATWG — HTML named character references
- WHATWG — Character reference parsing
- W3C — XML predefined entities
- OWASP — Context-dependent output encoding
本指南用浅白语言解释已公布的规则,不构成财务、法律或官方意见。政策会变动,做决定前请向上方链接的政府机构核实。
把这个工具嵌入你的网站
免费使用。把这段代码贴到你的网页,并保留指向 ToolSG 的链接。