OutputStreamWriter是字符流到字节流的桥梁,通过委托StreamEncoder将字符按指定编码(如UTF-8)转换为字节,再交由底层OutputStream写出;必须显式指定编码,写入后需flush或close以确保字节写出。

OutputStreamWriter 是 Java 中用于将字符流转换为字节流的桥梁类,它本身不直接写入字节,而是把字符按指定编码“翻译”成字节,再委托给底层的 OutputStream(如 FileOutputStream、SocketOutputStream)真正写出字节。
明确编码方式,构造时指定
必须在创建 OutputStreamWriter 时传入编码名称(如 "UTF-8"、"GBK"),否则会使用平台默认编码,容易导致乱码:
- ✅ 推荐写法:显式指定编码(推荐用 StandardCharsets 常量)
OutputStreamWriter writer = new OutputStreamWriter(new FileOutputStream("a.txt"), StandardCharsets.UTF_8);
- ⚠️ 避免写法:依赖系统默认编码(不可移植,易出错)
OutputStreamWriter writer = new OutputStreamWriter(new FileOutputStream("a.txt")); // 不推荐
立即学习“Java免费学习笔记(深入)”;
写入过程:字符 → 编码字节 → 输出流
调用 write() 方法(如 write(String)、write(char[])、write(int))时,OutputStreamWriter 会:
- 将传入的字符(或字符串)按构造时指定的编码规则,转换为对应的字节序列
- 把生成的字节交给底层 OutputStream 的
write(byte[])方法写出 - 注意:写入的是“编码后的字节”,不是原始字符的 Unicode 码点值
例如写字符串 "你好":
- 用 UTF-8 编码 → 得到 6 个字节:
[0xE4, 0xBD, 0xA0, 0xE4, 0xBD, 0xA5] - 用 GBK 编码 → 得到 4 个字节:
[0xC4, 0xE3, 0xBA, 0xC3] - 这些字节最终由 FileOutputStream 写入文件(或网络等)
别忘了 flush 和 close
OutputStreamWriter 内部有缓冲区。不刷新或关闭,字节可能滞留在内存中未写出:
- 调用
flush()强制把缓冲中的编码字节全部写出 - 调用
close()会自动 flush 并关闭底层 OutputStream - 建议配合 try-with-resources 使用,确保资源释放
try (OutputStreamWriter writer = new OutputStreamWriter(new FileOutputStream("a.txt"), StandardCharsets.UTF_8)) {<br> writer.write("Hello 世界");<br> writer.flush(); // 可选,close 会自动做<br>}
常见误区提醒
- OutputStreamWriter 不是“直接操作字节”的类 —— 它面向字符,编码逻辑封装在其内部
- 不能通过它获取编码后的字节数组;如需字节,应先用 String.getBytes(Charset) 转换,再用 OutputStream.write(byte[])
- 编码错误(如用 UTF-8 解码 GBK 字节)会导致乱码,但 OutputStreamWriter 本身不会报错 —— 错误发生在读取端


















