关于此工具
URL 编解码(又称百分号编码,Percent-encoding)是 RFC 3986 规定的通用资源标识符转换机制。在互联网传输中,URL 只能使用有限的 ASCII 可打印子集字符。当网址路径或查询参数中包含中文字符、空格或特殊保留字符(如 ?、&、=、#、+)时,必须将其转换为 '%' 紧跟两位十六进制字节的形式,以避免破坏 URL 的固有结构。
如何使用本工具(操作步骤)
输入需要编码或解码的 URL / 参数
在输入区粘贴完整的 URL 网址,或需要作为 GET 查询参数传递的原始文本(支持中文及特殊符号)。
执行转换并选择编解码模式
点击「URL 编码」将特殊符号转为 %XX 形式;或点击「URL 解码」将百分号编码还原为人类可读的原始文本。
一键复制转换后的有效 URL
结果实时生成,可直接点击复制,安全地嵌入至前端 Fetch 请求、后端 Redirect 重定向或第三方 Webhook 回调中。
支持全字符集 UTF-8 转码
全面支持中日韩字符、Emoji、换行符以及空格,精准将多字节 Unicode 拆解为 UTF-8 字节并按百分号编码。
浏览器本地处理,数据零上传
无需经过远程中转,即使您在 URL 参数中携带了未脱敏的用户 Token、跳转链接或业务参数,也能确保绝对隐私安全。
智能识别保留字符与参数分隔符
帮助开发者区分整个 URL 编码(不转义协议与域名斜杠)与单一参数组件编码(严格转义所有保留字)的业务差异。
URL 编码核心概念与经典避坑指南
- •分清 encodeURI 与 encodeURIComponent:encodeURI 不会转义 '?', '&', '=', '/' 等保留字符(用于对完整网址转码);而 encodeURIComponent 会转义除英数字外的几乎所有符号,专门用于单个参数值的转码,千万不要混用。
- •警惕 '+' 符号与空格的歧义:在 application/x-www-form-urlencoded 格式中,空格通常被转换为 '+';但在标准 RFC 3986 URL 路径中,空格必须为 '%20'。如果参数本身含有真正的加号(如 Base64 字符串中的 '+'),必须强制编码为 '%2B',否则后端解析时会被错误视为空格!
- •避免二次双重编码(Double Encoding):如果一个原本已经是 %20 的字符串再次被编码,就会变成 %2520(% 自身被转义为 %25)。解析前请确认入参是否已被上层网关处理过。
代码与转换对比示例
含中文与参数的 URL 编码转换对照
https://example.com/search?keyword=前端 工具&lang=zhhttps://example.com/search?keyword=%E5%89%8D%E7%AB%AF%20%E5%B7%A5%E5%85%B7&lang=zh* 中文“前端 工具”被精准转为 UTF-8 字节(每个汉字占 3 个字节),空格被转为 %20。
各语言中 URL 编解码内置函数参考
// 参数值编码(推荐)
const safeParam = encodeURIComponent("前端 工具");
// 完整 URL 编码(保留 :// 等)
const safeUrl = encodeURI("https://example.com/路径");import urllib.parse
# 参数编码 (空格转为 + 或 %20)
safe_param = urllib.parse.quote("前端 工具")
# 解码
raw_text = urllib.parse.unquote(safe_param)* 在前端开发中,拼接 GET 查询参数值务必使用 encodeURIComponent 而不是 encodeURI。
常见问题解答
Q: 为什么 GET 请求中的 Base64 字符串经常在后端解码出错?
A: 因为 Base64 包含 '+' 和 '/' 字符。如果在 URL 中没有使用 encodeURIComponent 将 '+' 转义为 '%2B',后端 Web 框架接收到时会自动把 '+' 还原为空格 ' ',导致 Base64 结构损坏无法解码。
Q: URL 编码是大小写敏感的吗(%2F vs %2f)?
A: 根据 RFC 3986 规范,百分号编码中的十六进制字符是不区分大小写的,%2F 和 %2f 代表完全相同的字节。但规范推荐使用大写字母以获得最佳的兼容性与规范一致性。
Q: 哪些字符属于无需转码的“非保留字符”(Unreserved Characters)?
A: 根据标准,英文字母(A-Z, a-z)、十进制数字(0-9)以及四个特殊标点符号:连字符 '-'、下划线 '_'、句点 '.'、波浪号 '~' 属于非保留字符,在任何情况下均无需进行 URL 编码。