OutputStreamWriter使用与编码转换教程

OutputStreamWriter 是 Java 中连接字符流与字节流的关键桥梁，核心功能是将 Unicode 字符按指定编码（如 UTF-8）精准“翻译”为字节序列并写入底层输出流（如文件或网络连接），其正确使用依赖三大要点：必须显式指定编码以避免平台默认编码导致的乱码和不可移植问题、务必通过 flush 或 try-with-resources 确保缓冲数据及时落盘、还可灵活配置编码错误处理策略（如自动替换非法字符），掌握这些细节，才能真正实现跨平台、健壮且可维护的文本输出。

OutputStreamWriter 的核心作用，就是把字符（char）按指定编码“翻译”成字节（byte），再写入底层的字节输出流（如 FileOutputStream 或网络 Socket 输出流）。它本身不直接操作字节，而是作为字符流与字节流之间的“编码桥梁”。

明确角色分工：Writer 负责编码，Stream 负责传输

OutputStreamWriter 不是独立的“流终点”，它必须包装一个已存在的 OutputStream（比如文件、内存、网络连接）：

• 你调用 write("你好")，它拿到的是 Unicode 字符序列；
• 它根据构造时指定的字符集（如 "UTF-8"），将每个字符转换为对应的字节序列；
• 再把生成的字节交给底层 OutputStream 实际写出。

正确创建 OutputStreamWriter 并指定编码

务必显式传入字符集名称，避免依赖平台默认编码（极易出错）：

// ✅ 推荐：明确指定 UTF-8
OutputStream os = new FileOutputStream("data.txt");
OutputStreamWriter osw = new OutputStreamWriter(os, "UTF-8");

// ✅ Java 7+ 可用 StandardCharsets（类型安全）
OutputStreamWriter osw2 = new OutputStreamWriter(os, StandardCharsets.UTF_8);

// ❌ 避免：无参构造，用系统默认编码（Windows 是 GBK，Linux/macOS 常是 UTF-8）
OutputStreamWriter bad = new OutputStreamWriter(os); // 不可移植

写入后记得 flush 和 close

OutputStreamWriter 内部有缓冲区。不刷新或关闭，内容可能滞留在内存中未真正写入底层流：

• osw.flush()：强制把缓冲区字节推给底层 OutputStream；
• osw.close()：自动 flush + 关闭底层流（推荐在 try-with-resources 中使用）。

try (OutputStream os = new FileOutputStream("out.txt");
     OutputStreamWriter osw = new OutputStreamWriter(os, "UTF-8")) {
    osw.write("Hello 世界");
    osw.write('\n');
    osw.write("123");
    // 自动 flush 并 close，确保字节落盘

编码错误如何处理？

若要写入的字符在目标编码中不存在（如用 ISO-8859-1 写中文），默认会抛 UnsupportedEncodingException（构造时）或 MalformedInputException（写入时）。可选择替换策略：

OutputStream os = new FileOutputStream("out.txt");
OutputStreamWriter osw = new OutputStreamWriter(
    os, 
    Charset.forName("ISO-8859-1")
        .newEncoder()
        .onUnmappableCharacter(CodingErrorAction.REPLACE)
        .onMalformedInput(CodingErrorAction.REPLACE)
);

这样遇到无法编码的字符，会替换成 ? 而非报错。

到这里，我们也就讲完了《OutputStreamWriter使用与编码转换教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！