outputstreamwriter 必须显式指定 utf-8 编码（如 new outputstreamwriter(os, standardcharsets.utf_8)），否则依赖平台默认编码（如 windows 的 gbk）会导致 emoji 乱码或替换，因 emoji 属于 unicode 辅助平面字符，需正确处理 4 字节 utf-8 序列及代理对。
OutputStreamWriter 默认使用平台默认编码，写入 Emoji 时极易出现乱码或替换字符（如 ），根本原因在于未显式指定 UTF-8 编码，且未确保底层 OutputStream 正确处理多字节 UTF-8 序列。
必须显式指定 UTF-8 编码构造 OutputStreamWriter
Java 中 OutputStreamWriter 的无参构造函数依赖 Charset.defaultCharset()，而 Windows 系统通常为 GBK，Linux/macOS 虽多为 UTF-8，但不可依赖。Emoji 属于 Unicode 辅助平面字符（如 ? U+1F30D），需 4 字节 UTF-8 编码，若编码不匹配，会截断或替换。
- ✅ 正确写法：
new OutputStreamWriter(outputStream, StandardCharsets.UTF_8) - ❌ 错误写法：
new OutputStreamWriter(outputStream)（隐式使用系统默认编码） - ⚠️ 注意：即使 OutputStream 是 FileOutputStream 或 SocketOutputStream，也必须在此层指定 UTF-8，而非仅靠文件/网络端“支持 UTF-8”
确保底层 OutputStream 不做额外字节转换
OutputStreamWriter 已负责将 char 序列按 UTF-8 编码为字节，因此下游 OutputStream 必须原样写出这些字节，不能被包装成带编码逻辑的类（如某些 HTTP 客户端的 Writer 封装）。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 避免用
PrintWriter包裹 OutputStreamWriter（除非明确传入 UTF-8 charset） - 写入文件时，直接使用
FileOutputStream；写入网络流时，确认 socket 输出流未被中间件拦截重编码 - 测试技巧：用
ByteArrayOutputStream捕获输出字节，用new String(bytes, UTF_8)验证是否与原始字符串一致
注意 String 中的代理对（Surrogate Pair）处理
Emoji 如 ??（U+1F468 U+200D U+1F4BB）含多个 Unicode 码点，Java String 内部以 UTF-16 存储，可能含代理对。OutputStreamWriter 在 UTF-8 模式下能自动正确编码代理对为 4 字节序列，无需手动拆分。
- 只要构造时指定了 UTF-8，
write("??")会输出合法 UTF-8 字节（共 11 字节） - 不要用
String.getBytes("UTF-8")预转字节数组再写入 OutputStream——这绕过 OutputStreamWriter 缓冲和 flush 机制，易出错 - 若需调试，可用
String.codePoints().forEach(cp -> System.out.printf("U+%04X ", cp))查看实际码点
完整可靠示例
以下代码可安全写入含 Emoji 的文本到文件：
try (FileOutputStream fos = new FileOutputStream("emoji.txt");
OutputStreamWriter osw = new OutputStreamWriter(fos, StandardCharsets.UTF_8);
BufferedWriter bw = new BufferedWriter(osw)) {
bw.write("Hello ?! 你好 ??");
bw.newLine();
bw.flush(); // 确保缓冲区内容写出
}
打开生成的文件用 UTF-8 编码查看器（如 VS Code、Notepad++ 切换编码为 UTF-8），Emoji 应正常显示。若仍为 ，请检查终端/编辑器是否真正以 UTF-8 解码，而非仅文件内容问题。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
