URLEncoder类用于将URL参数值编码为application/x-www-form-urlencoded格式。它保持字母、数字及. - * _不变，空格转为+，其余字符按UTF-8转字节再十六进制编码为%xy，仅适用于查询参数值而非完整URL或路径。
URLEncoder类的核心作用
URLEncoder类用于将字符串转换为符合 application/x-www-form-urlencoded 格式的URL安全字符串。它不是给整个URL（如https://example.com/path?x=1）编码，而是专门处理URL中**参数值部分**（比如x=我是中文里的“我是中文”），确保空格、中文、符号等能被正确传输，避免被服务器截断或解析出错。
URL编码的具体规则
URLEncoder.encode() 按照标准规范对字符做如下处理：
- 字母（a–z、A–Z）、数字（0–9）以及 . - * _ 这5个符号保持原样，不编码
- 空格（
' '）被转为 + 号（注意：不是%20；若需%20，后续需手动替换） - 其他所有字符（包括中文、标点、emoji等）先按指定编码（如UTF-8）转成字节，再每字节表示为 %xy 形式（xy为两位十六进制）
- 编码结果中只含 ASCII 字符，可安全拼入 URL 查询参数（如
?name=%E4%BD%A0%E5%A5%BD）
必须注意的两个关键点
实际使用中容易踩坑，务必确认以下两点：
-
字符集必须显式指定：不能只写
URLEncoder.encode(s)（已废弃）。必须传入编码名，如"UTF-8"，否则可能用平台默认编码（如GBK），导致服务端解码失败 -
编码仅适用于参数值，不适用于整个URL路径：例如
https://api.com/user/张三中的“张三”在路径段，应使用PathEncoder或手动处理；URLEncoder只适合?q=张三这类查询参数值
典型使用示例
一段安全、简洁的编码调用方式：
立即学习“Java免费学习笔记（深入）”；
String raw = "Hello 世界 & test@123";
try {
String encoded = URLEncoder.encode(raw, "UTF-8");
// 结果：Hello+%E4%B8%96%E7%95%8C+%26+test%40123
System.out.println(encoded);
} catch (UnsupportedEncodingException e) {
throw new RuntimeException(e);
}编码后可直接拼入GET请求参数，如：http://api.example.com/search?q=Hello+%E4%B8%96%E7%95%8C+%26+test%40123
