HTML 实体编码与解码使用指南

输入文本并设置模式即可处理 HTML 实体：非空文本在模式严格为 encode 时进行编码，其他模式值则进行反转义。空文本会成功返回空的转换文本，不执行转换。

先了解工具的用途

HTML 实体是文本在网页内容中常见的一种表示方式。当原始文字里含有需要转义的字符时，可以先用编码路径处理；当输入已经是实体表示、需要还原为文字时，可以使用反转义路径。这个工具接收文本和模式两个输入，适合在整理片段、检查转换结果或准备网页相关内容时使用。模式未提供时，默认按编码处理。使用前先明确目标：你是要把非空文本转换成实体表示，还是要把已有的实体表示还原成文本。

操作步骤：输入文本并选择模式

1. 在文本输入控件中填写要处理的内容。输入可以是普通文字，也可以是包含实体表示的非空文本。若只是查看空输入的处理结果，也可以不填写文本，但此时不会发生编码或反转义。
2. 设置模式。需要处理非空文本并执行 HTML 转义时，模式值要严格写成 encode。未提供模式时，默认使用编码。需要执行 HTML 反转义时，使用一个不同于 encode 的模式值；非空文本在这条路径上会执行反转义。
3. 提交处理并查看成功结果。非空文本会根据模式进入相应路径；空文本则直接成功返回空的转换文本，同时保留提交的模式，不执行其中任何一种转换。
4. 按目标核对返回内容。编码任务应检查文本是否呈现为预期的实体表示，反转义任务应检查实体表示是否还原为预期文字。若结果没有按计划改变，先回看文本是否为空，再检查模式值是否严格匹配 encode。不要把“成功”单独当作内容已经发生变化的依据。

如何理解结果及其边界

判断结果时，先看输入是否为空，再看模式的具体值。对于非空文本，只有严格等于 encode 的模式才进入 HTML 转义路径；大小写不同或采用其他值时，会进入 HTML 反转义路径。这里的“其他值”并不表示被拒绝，而是对应另一条处理路径，因此模式填写错误可能得到成功结果，却与原本想要的方向不同。

空文本需要单独理解：工具会成功返回空的转换文本，并保留提交的模式，但没有应用编码或反转义操作。因而，空结果既可能是输入本来为空，也可能是你正在检查空输入的行为，不能仅凭成功状态判断转换已经完成。对于非空输入，则应把原文、目标方向和返回文本放在一起检查。

使用示例

开发者准备把一段含特殊字符的文本放入 HTML 内容中，因此先提交非空文本并选择编码模式。

在文本框输入包含特殊字符的非空内容，将模式设为 encode，然后提交处理。

提交后应得到成功结果，其中包含处理后的文本表现；编码场景对应 HTML 转义后的内容。

使用限制

• 空文本不会产生转换；只有非空文本才会根据模式进入编码或反转义路径。

常见错误

• 如果把模式写成 Encode、decode 或其他非 encode 值，却期待编码结果，原因是编码路径要求模式严格为 encode。需要编码时请改用 encode；需要反转义时再使用不同的模式值，并结合返回文本检查方向。

常见问题

如何使用 HTML 实体工具进行编码？

当文本为非空内容时，将模式严格设为 encode，再提交处理即可进入 HTML 转义路径；未提供模式时也默认按编码处理。

如何使用 HTML 实体工具进行解码？

当文本为非空内容时，使用不同于 encode 的模式值会进入 HTML 反转义路径；提交前请确认模式值，以免处理方向与目标不一致。

输入为空时会发生什么？

当文本为空时，工具会成功返回空的转换文本，并保留提交的模式；这表示空输入已完成处理，不表示编码或反转义已经应用。