JavaScript 字符串编码：encodeURI 与 encodeURIComponent 的差异

<p>encodeURI用于编码完整URL，保留协议和路径结构，不编码: / ? # @等字符，适用于整体URL编码；encodeURIComponent用于编码URL片段如参数值，会编码包括?=&在内的特殊字符，防止解析错误。两者不可互换使用，否则可能导致服务器解析失败或链接无效。</p>

在处理 URL 中的字符串时，JavaScript 提供了两个常用于编码的函数：encodeURI 和 encodeURIComponent。它们看起来相似，但用途和行为有明显区别。理解它们的差异，能避免传递参数出错或服务器解析失败。

encodeURI：保留 URL 结构

encodeURI 用于对整个 URL 进行编码，确保其格式合法。它不会编码属于 URL 语法结构的字符，比如冒号、斜杠、问号、井号等。

适用场景：你想编码一个完整的 URL，但保持其基本结构不变。

• 不编码字符：:、/、?、#、@
• 只编码中文、空格、重音符号等非 ASCII 字符

示例：

立即学习“Java免费学习笔记（深入）”；

encodeURI("https://example.com/搜索?q=你好")
// 输出："https://example.com/%E6%90%9C%E7%B4%A2?q=%E4%BD%A0%E5%A5%BD"

可以看到，? 和 / 没有被编码，只有中文和空格等被转义。

encodeURIComponent：编码所有特殊字符

encodeURIComponent 更彻底，它假设你传入的是 URL 的一部分（如查询参数值），因此会编码几乎所有特殊字符，包括 /、?、= 等。

腾讯云AI代码助手

基于混元代码大模型的AI辅助编码工具

98

查看详情

适用场景：编码 URL 查询参数的键或值，确保不会破坏整体 URL 结构。

• 编码几乎所有非字母数字字符
• 包括：/、?、=、&、#、% 等

示例：

立即学习“Java免费学习笔记（深入）”；

encodeURIComponent("name=张三&age=25")
// 输出："name%3D%E5%BC%A0%E4%B8%89%26age%3D25"

等号和与号也被编码，防止它们被误认为是参数分隔符。

关键区别总结

• encodeURI：适合编码完整 URL，保留协议、路径结构
• encodeURIComponent：适合编码 URL 的片段，如参数值，确保特殊符号不干扰解析
• 不要用 encodeURI 编码参数值，否则 & 或 = 可能导致参数解析错误
• 不要用 encodeURIComponent 编码整个 URL，否则 :// 会被破坏，变成无效链接

基本上就这些。选对方法，URL 才能正确传递数据。

以上就是JavaScript 字符串编码：encodeURI 与 encodeURIComponent 的差异的详细内容，更多请关注php中文网其它相关文章！