URL 编码

最新推荐文章于 2025-08-05 18:04:34 发布

原创最新推荐文章于 2025-08-05 18:04:34 发布 · 1.6k 阅读

本内容遵循CC 4.0 BY-SA版权协议

标签

#java

39 篇文章

订阅专栏

该文章已生成可运行项目，

URL 编码（也称为百分号编码，Percent-Encoding）是一种在 URL 中传输非 ASCII 字符和保留字符的机制，符合 RFC 3986 标准。

因为 URL 只能包含以下几类字符：

其他字符（如空格、中文、特殊符号）必须编码后才能出现在 URL 中，以避免语义冲突。

原始字符	编码形式	说明
空格	`%20` 或 `+`	在 `application/x-www-form-urlencoded` 中是 `+`
`!`	`%21`
`#`	`%23`	锚点标识，需编码
`%`	`%25`	百分号本身需编码
`+`	`%2B`	和空格冲突，需编码
`/`	`%2F`	路径分隔符，若用于参数需编码
中文、非 ASCII	UTF-8 后编码	如：`中` → UTF-8：`E4B8AD` → `%E4%B8%AD`

String encoded = URLEncoder.encode("中 文", "UTF-8");  // %E4%B8%AD+%E6%96%87
String decoded = URLDecoder.decode(encoded, "UTF-8"); // 中 文

encodeURIComponent("中 文");   // "%E4%B8%AD%20%E6%96%87"
decodeURIComponent("%E4%B8%AD%20%E6%96%87");

import urllib.parse
urllib.parse.quote("中 文")   # %E4%B8%AD%20%E6%96%87
urllib.parse.unquote('%E4%B8%AD%20%E6%96%87')

函数	是否编码空格	是否编码 `/`	用途
`encodeURI`	❌（保留空格）	❌	编码整个 URL，不编码分隔符
`encodeURIComponent`	✅ `%20`	✅ `%2F`	编码 URL 的参数值部分

错误使用	正确做法
中文直接拼到 URL 中	使用 UTF-8 编码后再转为 `%xx`
用 `+` 表示加号	`+` 要转义为 `%2B`
忘记对查询参数做编码	所有参数值都要 `encodeURIComponent()`
多次编码造成错误	避免重复 `encode`/`decode`

场景	是否需要 URL 编码
GET 请求参数	✅ 是
POST 表单提交（application/x-www-form-urlencoded）	✅ 是（空格转 `+`）
浏览器地址栏直接输入中文	浏览器自动编码
JSON 接口、application/json	❌ 一般不编码