Java的Base64类是JDK 8引入的标准编码工具，支持Basic、URL-safe和MIME三种方案，线程安全；编码需先转UTF-8字节数组再encode()，解码后须用相同字符集还原字符串；URL编码用'-'和'_'替代'+','/'，MIME每76字符换行；非加密手段，仅用于编码转换。
Java 中的 Base64 类（位于 java.util 包）是 JDK 8 引入的标准编码工具，无需第三方依赖，支持基本（Basic）、URL 安全（URL-safe）和 MIME 三种编码方案，线程安全，使用简单可靠。
Base64 编码：用 encode() 获取字节数组的编码结果
编码操作通过 Base64.getEncoder() 获取编码器实例，调用 encode(byte[]) 返回编码后的字节数组；如需字符串形式，再用 new String(encodedBytes) 或直接用 encodeToString(byte[]) 一步到位。
-
注意：输入必须是原始字节（如 UTF-8 编码后的字符串），不能直接对中文字符串调用 encode —— 先用
"文本".getBytes(StandardCharsets.UTF_8) - 基本编码不换行、不含空格，适合 URL 和文件名场景；MIME 编码每 76 字符加换行符，适合邮件附件
- 示例：
String s = Base64.getEncoder().encodeToString("Hello".getBytes()); // 输出 "SGVsbG8="
Base64 解码：用 decode() 还原原始字节
解码通过 Base64.getDecoder() 获取解码器，调用 decode(String) 或 decode(byte[]) 得到原始字节数组；若原数据是字符串，需按相同字符集（如 UTF-8）构造字符串。
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 解码时若输入含非法字符（如中文、多余空格、长度非 4 倍数），会抛
IllegalArgumentException - URL 安全编码使用 '-' 和 '_' 替代 '+' 和 '/'，解码时必须用
Base64.getUrlDecoder()，混用会失败 - 示例：
byte[] bs = Base64.getDecoder().decode("SGVsbG8="); String s = new String(bs, StandardCharsets.UTF_8); // "Hello"
三种编码器的区别与选用场景
JDK 提供三个静态工厂方法，对应不同用途：
立即学习“Java免费学习笔记（深入）”；
-
Base64.getEncoder()：标准 Base64，含 '+'、'/' 和 '='，适用于通用存储或内部传输 -
Base64.getUrlEncoder()：URL 和文件系统友好，用 '-' 和 '_' 替代 '+' 和 '/'，默认不补等号（可链式调用.withoutPadding()） -
Base64.getMimeEncoder()：符合 RFC 2045，每行最多 76 字符并换行，适合邮件协议
常见问题与避坑提醒
实际使用中容易忽略几个关键点：
- 编码/解码前后字符集必须一致，否则中文乱码 —— 推荐统一用
StandardCharsets.UTF_8 - 不要用
String.getBytes()无参重载，它依赖系统默认编码，跨环境不稳定 - Base64 不是加密！仅做编码转换，无安全性，敏感数据仍需 AES 等加密后再 Base64
- 流式处理大文件时，可用
Base64.Encoder.wrap(OutputStream)避免内存溢出
