Java常用文件操作类库与FileOutputStream_技术教程

FileOutputStream写中文易乱码因其只处理字节且依赖系统默认编码；推荐用Files.write()或BufferedWriter+Files.newBufferedWriter()，它们自动处理编码、目录创建和资源管理。

FileOutputStream 不适合直接处理文本文件，它只负责写入原始字节 —— 如果你用它写中文字符串却没指定编码，大概率出现乱码；而所谓“常用文件操作类库”，其实多数是帮你绕过 FileOutputStream 的底层细节。

为什么 FileOutputStream 写中文容易乱码

因为 FileOutputStream 是 OutputStream 子类，只认 byte[]，不理解字符编码。调用

write(String.getBytes()) 时，若未显式传入编码（如 "UTF-8"），会走平台默认编码（Windows 常为 GBK），Linux/macOS 多为 UTF-8，一换环境就出问题。

常见错误现象：

FileOutputStream fos = new FileOutputStream("a.txt");
fos.write("你好".getBytes()); // 没指定编码 → 依赖系统默认 → 不可移植

必须写成 "你好".getBytes(StandardCharsets.UTF_8) 才安全
更推荐跳过 FileOutputStream，直接用带编码的高层 API
它无法自动创建父目录（new File("dir/a.txt").getParentFile().mkdirs() 得手动补）

Files.write() 是最简替代方案（Java 7+）

Files.write() 封装了 FileOutputStream + 编码 + 目录创建，一行顶原来五行，且默认覆盖写入：

Files.write(Paths.get("out.txt"), "你好世界".getBytes(StandardCharsets.UTF_8));

如果要追加写入，加 StandardOpenOption.APPEND：

Files.write(Paths.get("log.txt"), "新日志\n".getBytes(StandardCharsets.UTF_8),
    StandardOpenOption.CREATE, StandardOpenOption.APPEND);

自动创建不存在的父目录（只要权限允许）
不支持按行写入（比如没有内置换行符处理），需自己拼 "\n"
对大文件慎用 —— 整个内容会先加载进内存再写入

BufferedWriter + Files.newBufferedWriter() 适合文本流场景

当你要频繁写多行、或需要格式化输出（如 printf）、或配合 try-with-resources 自动关闭时，这是比裸用 FileOutputStream 更自然的选择：

try (BufferedWriter writer = Files.newBufferedWriter(
        Paths.get("data.txt"), StandardCharsets.UTF_8)) {
    writer.write("第一行");
    writer.newLine();
    writer.write("第二行");
}

内部仍用 FileOutputStream，但你完全不用碰字节和编码转换
newBufferedWriter() 默认是覆盖写入；追加需加 StandardOpenOption.APPEND
注意：write(String) 不自动换行，newLine() 才写系统适配的换行符（\r\n 或 \n）

Apache Commons IO 和 Guava 的定位差异

这两个库不是为了“取代” FileOutputStream，而是补足 JDK 文件操作的常见缺失：

FileUtils.writeStringToFile(file, content, "UTF-8")（Commons IO）—— 简单粗暴，但已标记为 @Deprecated，新项目建议用 Files.write()
Files.asCharSink(file, Charsets.UTF_8).write(content)（Guava）—— 类似 Files.newBufferedWriter()，但 Guava 20+ 已废弃 Files 工具类，转向 JDK 原生
真正值得留下的功能是：批量复制、计算校验和、读取全部行到 List、安全删除非空目录等 —— 这些 JDK 还没原生支持

复杂点在于：很多老项目还在用 FileOutputStream + OutputStreamWriter 手动组合，这种写法没错，但容易漏关流、漏 flush、漏指定编码。现在 JDK 原生已有足够好用的替代，没必要再手撸底层流链路。