Java中使用PrintWriter向多个文件写入内容的正确方法

Ja va中使用PrintWriter向多个文件写入内容的正确方法

在Ja va开发中，批量向一组文件写入数据是个挺常见的场景。比如，你需要把处理好的几组结果分别存进 output_1.txt、output_2.txt 等等。代码写起来似乎很简单：创建PrintWriter，调用println方法。但很多开发者都踩过同一个坑——文件创建了，打开一看却是空的。问题出在哪？关键在于，数据可能还躺在内存缓冲区里睡大觉，根本没落到磁盘上，同时文件句柄也一直占着没放。

究其根本，PrintWriter（以及它底层常用的FileWriter）默认是启用缓冲的。而那个容易被忽略的close()方法，身兼双职：它既负责把缓冲区里的数据“推”出去（即执行flush()），也是释放操作系统资源的关键动作。

我们来看看典型的问题代码逻辑：

• 循环里每次都新建FileWriter和PrintWriter，但写完就“撒手不管”了，从未调用close()。
• 缺少必要的异常处理。万一写到一半磁盘满了或者权限出问题，程序可能直接异常终止。结果就是，后面的文件没写进去，前面已经打开的流也没关上，造成了资源泄漏。

那么，正确的姿势是什么？答案就是：使用 try-with-resources 语法（JDK 7及以上版本）。它能帮你自动管理资源，确保close()方法被调用（这相当于先flush()再关闭），无论程序是正常执行完毕还是中途抛出异常。

import ja va.io.IOException;
import ja va.nio.file.Files;
import ja va.nio.file.Path;
import ja va.nio.file.Paths;
import ja va.io.PrintWriter;

String[] outputs = {"output_1.txt", "output_2.txt"};
for (String filename : outputs) {
    try (PrintWriter writer = new PrintWriter(Files.newBufferedWriter(Paths.get(filename)))) {
        writer.println("write this to file");
        // 可以继续写入多行，无需手动flush()
    } catch (IOException e) {
        System.err.println("写入文件 " + filename + " 时出错: " + e.getMessage());
        // 建议在这里记录日志或根据业务需求处理异常
    }
}

这里有几个关键点需要说明：

立即学习“Ja va免费学习笔记（深入）”；

• 代码中使用了Files.newBufferedWriter(Paths.get(filename))。这比直接new一个FileWriter更高效，因为它返回的是带缓冲的BufferedWriter。此外，这种方式还方便你指定字符编码，比如.newBufferedWriter(path, StandardCharsets.UTF_8)。
• 在try (Resource res = ...)括号里声明的资源，必须实现AutoCloseable接口，而PrintWriter正好符合这个要求。
• try-with-resources结构的精妙之处在于，当语句块执行结束时（无论是正常结束还是因异常跳出），它都会自动执行资源的close()方法。这就从根本上杜绝了资源泄漏的可能。

当然，使用时也要注意几个细节：

• 不要在try-with-resources语句块外面再去手动调用writer.close()，否则可能会引发IllegalStateException。
• 如果你需要在写入过程中就实时看到文件内容（例如为了调试），可以显式地调用一下writer.flush()。不过在大多数情况下，这并非必要，因为最终的close()已经包含了刷新操作。
• 避免在循环外复用同一个PrintWriter实例去写不同的文件，因为它内部绑定了一个特定的底层输出流。

最后总结一个核心原则：永远不要指望垃圾回收器（GC）来帮你关闭文件流。把使用try-with-resources变成一种习惯，这是构建健壮、可维护的Ja va I/O代码的坚实基础。