OutputStreamWriter的核心价值是将字符流按指定编码转为字节流，解决多语言变量输出乱码问题；必须显式指定UTF-8编码，直接write字符串，配合flush、try-with-resources及UTF-8验证确保字符完整性。
OutputStreamWriter 的核心价值，就在于它能把字符流按指定编码转成字节流——这正是解决多语言变量输出的关键环节。默认用系统编码写入中文、日文或阿拉伯文，极大概率出现乱码；而 OutputStreamWriter 让你主动掌控编码规则，确保变量内容原样落地。
明确指定编码，避免系统默认陷阱
不要依赖构造函数中只传 OutputStream 的方式，那会使用平台默认 charset（Windows 常是 GBK，Linux/macOS 多为 UTF-8），跨环境极易出错。
- 始终显式传入 StandardCharsets.UTF_8 或 "UTF-8" 字符串
- 例如：new OutputStreamWriter(new FileOutputStream("log.txt"), StandardCharsets.UTF_8)
- 如果变量本身含 emoji、繁体字、越南文等扩展 Unicode 字符，UTF-8 是最稳妥选择
写入变量时保持字符完整性
变量内容（如 String name = "张伟"; 或 String msg = "こんにちは";）本质是 Unicode 字符序列。OutputStreamWriter 会在写入前自动将其编码为 UTF-8 字节，无需手动调用 getBytes()。
- 直接用 writer.write(name) 或 writer.write(msg)
- 避免混用：不要对变量先做
name.getBytes(StandardCharsets.UTF_8)再用字节流写——这绕过了 OutputStreamWriter 的转换逻辑，反而容易出错 - 若需拼接，用 write(String) 或 write(String, off, len)，不丢失原始字符语义
配合缓冲与资源管理，保障输出可靠
多语言文本常用于日志、配置导出等场景，数据一旦写错难追溯。因此 flush 和 close 不可省略。
- 每条关键变量输出后，调用 writer.flush() 确保即时落盘（尤其在调试或实时日志中）
- 务必用 try-with-resources 自动关闭：try (Writer w = new OutputStreamWriter(...)) { w.write(variable); }
- close() 会隐式 flush，但显式 flush 可控性更强，适合分段写入长文本或结构化变量
验证输出是否真正生效
写完别急着认为“没问题”，乱码往往在读取端才暴露。建议：
- 用支持 UTF-8 的编辑器（如 VS Code、Notepad++）打开生成文件，确认编码识别为 UTF-8 无 BOM
- 在命令行用 file -i filename（Linux/macOS）或 chcp + 手动查看（Windows）辅助判断
- 若后续要用 InputStreamReader 读回，必须用相同 charset 构造，否则解码失败
