outputstreamwriter的核心作用是将字符按指定编码转换为字节并写入底层字节流,作为字符流与字节流间的编码桥梁;必须包装现有outputstream,需显式指定编码(如utf-8),写入后应flush或close,可配置错误处理策略。

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)
);
这样遇到无法编码的字符,会替换成 ? 而非报错。










