URL 编码用于把中文、空格、百分号、井号、问号、等号、斜杠等特殊字符转换成适合放在 URL 中的形式。排查接口和跳转问题时，应先判断要处理的是完整 URL，还是单个参数值。
处理查询参数、中文链接和特殊字符时，可直接粘贴并复制编码结果。
URL 中可能包含访问令牌、邮箱、手机号、订单号或内部路径。公开分享或粘贴到工具前，应先确认内容是否适合处理。
当你要把一段文本放进 query 参数里，通常只编码参数值，不要把整个 URL 全部编码。
%25 通常代表百分号本身被编码，常见于重复编码或手动拼接错误。
在部分表单编码场景中，加号可以表示空格；但不同上下文的规则并不完全相同，调试时要结合具体接口确认。
URL 编码用于让中文、空格、符号和查询参数在地址中安全传输。排查时要确认需要编码的是整个 URL、单个参数值，还是路径片段。
URL 编码最常见的错误是把所有内容都用同一种方式处理。完整 URL、path segment、query key、query value 和 fragment 的规则不同。中文、空格、斜杠、问号、等号、百分号在不同位置含义不同；如果在错误位置重复编码，接口可能收到完全不同的参数。
原始查询值：红色 鞋子/男款
作为 query value：%E7%BA%A2%E8%89%B2%20%E9%9E%8B%E5%AD%90%2F%E7%94%B7%E6%AC%BE在 query value 中，斜杠只是值的一部分，因此应被编码为 %2F。但在路径中，斜杠通常表示层级分隔，不能随意编码或解码。排查 URL 错误时，应先标记每个字符所在位置，再决定使用 encodeURI、encodeURIComponent 还是 URLSearchParams。
| 位置 | 典型字符 | 建议处理 |
|---|---|---|
| 完整 URL | https://、?、& | 不要整体用组件编码，否则结构字符会被破坏。 |
| 查询参数值 | 中文、空格、斜杠、等号 | 使用组件级编码，避免值被误拆分。 |
| 已编码文本 | %E4%B8%AD | 先判断是否已经编码，避免变成 %25E4...。 |
+ 时确认它来自表单编码还是原始加号。URL 中经常包含 session、token、邮箱、订单号、广告点击 ID 或内部路径。用于排查时应删除或替换这些值，只保留字符类型和参数结构。不要把带认证信息的完整生产 URL 直接粘贴到公开页面、issue 或第三方聊天系统。
URL 结构可参考 WHATWG URL Standard；浏览器 JavaScript 的组件编码行为可参考 MDN 的 encodeURIComponent() 与 URLSearchParams 文档。
以下专题把本指南中的常见问题拆成更小的可复现案例，适合在复制、发布或提交 issue 前逐项核对。
本页的排查建议结合浏览器行为、公开标准和常见开发实践整理。涉及线上发布、安全决策或兼容性判断时，请以官方规范和你自己的运行环境为准。
本页由 Ymir Tool editorial review 维护，最后更新于 2026-06-01。页面示例使用合成输入，避免展示真实密钥、客户资料或生产日志。复制结果到正式流程前，请结合对应工具页、官方规范和你自己的运行环境再次确认。