URL 编码与解码的原理及应用
在互联网底层协议与 Web 开发中，URL（统一资源定位符）只能使用 ASCII 字符集中的受限字符。当 URL 中需要包含空格、中文字符或特殊符号（如 &、=、?）时，就必须使用百分号编码（Percent-encoding）进行转换。
URL 编码的原理是将非 ASCII 字符或特殊字符转换为其对应的 UTF-8 字节序列，然后每个字节前加上百分号 %。例如，中文字符“上海”在 UTF-8 编码下占用 6 个字节，经过 URL 编码后会转换为 %E4%B8%8A%E6%B5%B7 形式的百分号转义序列。
在实际应用中，开发人员、内容编辑和支持人员经常需要对查询参数、路径片段或表单值进行编码，以确保数据在网络传输中不丢失、不解析错乱。相反地，当拿到一段包含大量百分号的编码后的链接时，则需要通过解码将其还原为人类可读的文本。
完整 URL 与 URL 组件的编码差异
在进行 URL 转换时，必须区分“组件”与“完整 URL”两种不同的处理范围，这对应着不同的编码规则：
- 组件（对应
encodeURIComponent/decodeURIComponent）：用于处理准备拼接到 URL 中的某一个参数值或路径片段。在这种模式下，所有非字母数字字符（包括:、/、?、&、=等）都会被强制编码。例如，输入hello world & city=上海，编码后会变成hello%20world%20%26%20city%3D%E4%B8%8A%E6%B5%B7。这样可以防止参数中的&或=破坏整个 URL 的结构。 - 完整 URL（对应
encodeURI/decodeURI）：用于处理一整条现成的链接。在这种模式下，工具会保留:、/、?、&、=等用于定义 URL 结构的特殊字符，只对空格、中文等非 ASCII 字符进行编码。这能保证转换后的链接依然可以被浏览器直接访问。
HTML 实体转义的作用
HTML 实体转义（HTML Entity Escaping）是 Web 开发中确保文本安全渲染的重要机制。在 HTML 文档中，某些字符具有特殊的语法含义，例如 < 和 > 用于定义标签，& 用于引入实体。
如果直接在 HTML 页面中插入包含这些符号的原始文本，可能会导致浏览器解析错误，甚至引发安全漏洞。通过将这些字符转换为对应的 HTML 实体（例如将 < 转义为 <，> 转义为 >，& 转义为 &，以及对引号和非 ASCII 文本进行转换），可以确保文本被浏览器安全地当作纯文本渲染，而不会被误执行为 HTML 代码。
需要注意的是，HTML 实体转义与安全过滤（Sanitization）不同。转义只是改变了字符的表示形式以确保其在 HTML 属性或文本节点中安全显示，而过滤则是主动移除潜在的恶意代码（如 <script> 标签）。
异常处理与 UTF-8 规范
在解码 URL 时，百分号转义序列必须符合完整的 UTF-8 编码规范。如果输入的文本中包含不完整的百分号序列，解码程序将无法正确识别。
例如，输入了类似 %E0%A4%A 这样残缺的序列，由于其不满足 UTF-8 字节序列的完整性要求，工具会中断解码并提示错误信息：“这段 URL 文本里有残缺的百分号转义。” 确保输入数据的完整性是成功解码的前提。
本地处理与隐私说明
本工具在设计上充分保障用户的数据隐私。所有的 URL 编码、解码以及 HTML 实体转义、反转义操作均直接在您的浏览器本地完成。您的输入文本和转换结果不会上传到 BroBroGo 服务器，确保了处理过程的私密性。
本工具支持的最大输入长度为 2,000,000 个字符。如果输入内容超出此限制，系统会提示：“输入内容太大了，请控制在 {max} 个字符以内。”
常见问题
应该选 URL 组件还是完整 URL？
查询参数值、路径片段或表单值选组件；想保留: /? & = 这类 URL 结构字符时选完整 URL。
HTML 实体转义会改变什么？
它会把 <、>、&、引号和非 ASCII 文本转成实体，方便安全地粘贴进 HTML 文本或属性里。
为什么 URL 解码有时会失败？
百分号转义必须是完整的 UTF-8 序列。像 %E0%A4%A 这样的残缺序列无法可靠解码。