关键是在字符与字节转换边界显式、一致指定编码规则;应使用OutputStreamWriter包装字节流并传入StandardCharsets.UTF_8等明确编码,避免依赖默认编码导致跨平台乱码。

Java 中字符编码在字节流中正确转码,关键不是“把字节流强行改成某种编码”,而是**在字符与字节相互转换的边界上,显式、一致地指定编码规则**。字节流(如 FileOutputStream、Socket.getOutputStream())本身不认字符,只管写入原始字节;真正承担“字符→字节”职责的是 OutputStreamWriter——它才是你该用的转码入口。
用 OutputStreamWriter 包装字节流并指定编码
这是最标准、最安全的做法。它把字符写入逻辑和编码转换完全解耦,交由 JDK 内部的 StreamEncoder 处理:
- 必须传入底层
OutputStream(比如文件、网络流),不能单独创建 - 必须显式指定字符集,推荐用
StandardCharsets.UTF_8或"GBK"字符串 - 避免无参构造,否则依赖系统默认编码(Windows 是 GBK,Linux/macOS 多为 UTF-8),极易跨平台乱码
示例:
try (FileOutputStream fos = new FileOutputStream("out.txt");
OutputStreamWriter osw = new OutputStreamWriter(fos, StandardCharsets.UTF_8)) {
osw.write("你好,世界!"); // 自动按 UTF-8 编码成字节,再交给 fos 写出
}
手动转换时:getBytes() + new String() 必须配对使用同一编码
当你绕过字符流、直接操作字节数组(如用 ByteArrayOutputStream),就必须自己控制编解码过程:
立即学习“Java免费学习笔记(深入)”;
- 写入前:调用
str.getBytes(Charset)得到目标编码的字节数组 - 读取后:用
new String(byte[], Charset)按相同编码还原字符串 - 严禁混用:比如用 UTF-8 编码、却用 GBK 解码,或任一端省略 Charset 参数而用默认编码
常见错误场景:
ByteArrayOutputStream baos = new ByteArrayOutputStream();
baos.write("中文".getBytes()); // ❌ 用默认编码(可能是 GBK)
String s = baos.toString(); // ❌ 又用默认编码解析 → 极可能乱码
// ✅ 正确写法:
baos.write("中文".getBytes(StandardCharsets.UTF_8));
String s = baos.toString(StandardCharsets.UTF_8.name());
读写文件时优先用 InputStreamReader / OutputStreamWriter 而非 FileReader / FileWriter
FileReader 和 FileWriter 的构造函数不接受编码参数,内部强制使用平台默认编码,不可靠:
- 要读 GBK 编码的旧文本文件?用
InputStreamReader(new FileInputStream(...), "GBK") - 要写 UTF-8 文件供网页读取?用
OutputStreamWriter(new FileOutputStream(...), StandardCharsets.UTF_8) - 这样可确保“从字节到字符”和“从字符到字节”的两端编码完全可控、完全对称
记住核心逻辑:编码是双向映射,错一端就全错
Java 内存中所有 String 都是 Unicode(UTF-16),所谓“转码”,本质只有两步:
-
编码:Unicode 字符 → 指定编码的字节序列(如
str.getBytes(UTF_8)或OutputStreamWriter写入) -
解码:字节序列 → Unicode 字符(如
new String(bytes, UTF_8)或InputStreamReader读取)
只要这两步用的 Charset 完全一致,就不会乱码。不复杂但容易忽略。


















