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