← 首页

URL 编解码

模式:
输入 0 字符
输出 0 字符

功能特点

100% 隐私保护

所有编码和解码都在您的浏览器本地完成,数据不会发送到任何服务器。

两种编码模式

一键在 encodeURIComponent(用于参数)和 encodeURI(用于完整 URL)之间切换。

实时转换

输入时结果即时更新——无需每次改动都点击按钮。

完整 Unicode 支持

正确处理多字节字符:中文、日文、韩文、阿拉伯文、Emoji 等。

自动识别方向

自动判断输入是已编码文本还是纯文本,并相应转换。

交换输入/输出

使用交换按钮快速互换编码和解码文本,方便双向操作。

使用方法

选择编码模式

URL 参数选择 encodeURIComponent,完整 URL 选择 encodeURI。默认模式可满足大多数使用场景。

输入文本或 URL

将 URL、查询字符串或任何含特殊字符的文本粘贴到输入区域,工具会自动判断是否需要解码。

点击编码或解码

点击“编码”按钮进行百分号编码,或点击“解码”将百分号编码的字符串还原为可读文本。

复制结果

点击“复制”将输出内容复制到剪贴板。使用“交换”可快速反向操作。

encodeURI 与 encodeURIComponent 对比

字符 encodeURI encodeURIComponent 说明
空格 ( )%20%20两者都会编码空格
斜杠 (/)/(保留)%2FURI 保留路径分隔符
冒号 (:):(保留)%3AURI 保留协议分隔符
问号 (?)?(保留)%3FURI 保留查询分隔符
与号 (&)&(保留)%26URI 保留参数分隔符
等号 (=)=(保留)%3DURI 保留键值分隔符
井号 (#)#(保留)%23URI 保留片段标识符
中文 (中)%E4%B8%AD%E4%B8%AD两者都将非 ASCII 字符编码为 UTF-8 字节

常见问题

什么是 URL 编码(百分号编码)?
URL 编码又称百分号编码,会把 URL 中不安全或保留的字符替换为 % 加两位十六进制数字,表示该字符的字节值。例如,空格变为 %20,与号变为 %26。这样可确保 URL 有效,并能在所有系统中正确传输。
encodeURI 和 encodeURIComponent 有什么区别?
encodeURI 编码整个 URL,会保留 :、/、?、#、&、= 等在 URL 语法中有意义的结构字符。encodeURIComponent 编码单个 URL 组件(如查询参数值),会编码所有特殊字符,包括 encodeURI 保留的那些字符。参数值请使用 encodeURIComponent,完整 URL 请使用 encodeURI。
为什么 URL 中的空格会变成 %20?
根据 RFC 3986,URL 中不允许出现空格。空格的标准百分号编码表示是 %20。用 + 表示空格是 HTML 表单编码(application/x-www-form-urlencoded)遗留下来的约定,并非标准 URL 百分号编码的一部分。
可以编码中文、阿拉伯文或 Emoji 等非拉丁字符吗?
可以。非 ASCII 字符会先转换为 UTF-8 字节序列,然后对每个字节进行百分号编码。例如,中文字符“中”(U+4E2D)在 URL 中会变成 %E4%B8%AD,因为它的 UTF-8 编码为 3 个字节:0xE4、0xB8、0xAD。
我的数据会发送到服务器吗?
不会。所有编码和解码都使用 JavaScript 内置的 encodeURI / decodeURI / encodeURIComponent / decodeURIComponent 函数,完全在您的浏览器中运行,不会向任何服务器传输任何内容。
在 Web 开发中什么时候应该使用 URL 编码?
当 URL 中包含用户生成或动态数据时——查询参数、表单数据、路径片段和片段标识符——都应使用 URL 编码。它可以防止 URL 损坏和注入攻击,并确保特殊字符在各浏览器和服务器间被正确处理。

相关工具

关于 URL 编码/解码器

使用 FreeToolBox 免费在线编码和解码 URL——即时将 URL 中的特殊字符转换为其百分号编码形式,并可反向还原。URL 编码(又称百分号编码,定义于 RFC 3986)会将 URL 中不允许的字符替换为 % 加两位十六进制数字,表示该字符的字节值。这对于构建 API、拼接查询字符串、处理表单提交以及调试任何 Web 应用中与 URL 相关的问题的开发者而言必不可少。

本工具提供两种业界标准的编码模式:encodeURIComponent 用于编码单个 URL 参数(除非保留字符 A-Z、a-z、0-9、-、_、.、~ 外全部编码),encodeURI 用于编码完整 URL,同时保留 ://?#&= 等结构分隔符。它支持输入时实时转换、自动识别已编码与纯文本输入、适用于任何语言的完整 UTF-8 Unicode 支持,以及便捷的输入/输出互换功能。所有处理均使用 JavaScript 原生函数在您的浏览器中完成——数据绝不会离开您的设备。完全免费、即时、无需注册。

URL 编码的最佳使用场景

什么时候应该使用 URL 编码器而不是其他工具?

当问题在于为传输转义字符时,请使用URL 编码/解码器。如果您要在解码后调试更大的 API 响应或载荷,请继续使用 JSON 格式化。如果载荷还包含编码后的二进制数据或令牌,可搭配 Base64 编码/解码。

无需上传的工作流:内部链接、带签名的参数和测试 URL 都留在您的浏览器中,不会被粘贴到第三方编码器。

常见问题

应该使用 encodeURI 还是 encodeURIComponent?

对于已包含 :// 和 ?a=1 等分隔符的完整 URL,请使用 encodeURI。对于将插入 URL 的单个参数值、路径片段或用户输入,请使用 encodeURIComponent。

URL 编码为何存在:并非所有字符都是安全的

URL 仅允许使用一小部分非保留字符。空格以及 "&"、"="、"#" 等符号和非 ASCII 文本会破坏 URL 的解析方式,因此必须表示为百分号编码序列。这就是空格变成 %20、井号变成 %23 的原因。编码只是一种表示形式——服务器使用前会将其解码回原始内容。理解这一点,有助于您明白为什么粘贴的带符号 URL 有时可用、有时不可用,取决于它是否经过编码。

编码整个 URL 与只编码需要编码的部分

编码整个 URL 与只编码查询值之间有重要区别。如果编码整条路径,可能会破坏定义结构的斜杠和问号等分隔符。通常只需编码传入 URL 的单个数据值,保持结构部分不变。当用用户输入构建 URL 时,应分别编码每个值,而不是把原始值直接粘贴进字符串。这正是 URL 能否正常工作的关键区别。

常见解码错误提醒

最常见的错误是对已编码的内容再次解码,这会弄乱文本;或者完全不做编码,导致 URL 含有无法承载的字符。另一个误区是把空格和 "+" 当作相同的东西;在查询字符串中 "+" 通常表示空格,但在 URL 的其他部分它是字面加号。解码时,请在实际使用场景中检查结果,并记住显示的 URL 并不总是浏览器实际发起的底层请求。

反馈
通过 ko-fi.com 请我喝杯咖啡