Java 实例 – 文件写入（超详细）

Java 实例 – 文件写入：从零开始掌握数据持久化

在 Java 编程中，文件写入是一项基础但极其重要的技能。无论是记录日志、保存用户数据，还是导出报表，我们都需要将程序运行时的内存数据写入磁盘文件，实现数据的持久化。可以说，没有文件写入，程序就像没有记忆的机器人——运行完就忘了所有过程。

今天我们就来深入探讨 Java 实例 – 文件写入 的核心方法和最佳实践。文章将从最简单的 FileWriter 开始，逐步进阶到更安全高效的 BufferedWriter 和 Files.write()，并结合真实案例，帮助你真正掌握这一技能。

什么是文件写入？它为什么重要？

想象一下，你正在编写一个学生信息管理系统。用户输入姓名、年龄、成绩，系统把这些数据存在内存里。但如果程序突然崩溃，所有数据就消失了。这显然不可接受。

文件写入就是解决这个问题的关键。它把内存中的数据“落盘”——写入到硬盘文件中，即使程序关闭或电脑重启，数据依然存在。这就像我们把重要笔记写在纸上，而不是只记在脑子里。

Java 提供了多种方式实现文件写入，每种都有适用场景。接下来我们逐一学习。

使用 FileWriter 写入文本文件

最基础的文件写入方式是 FileWriter。它直接将字符数据写入文件，适合小量文本操作。

import java.io.FileWriter;
import java.io.IOException;

public class FileWriteExample {
    public static void main(String[] args) {
        // 定义要写入的文件路径
        String filename = "students.txt";

        // 使用 try-with-resources 自动关闭资源，避免内存泄漏
        try (FileWriter writer = new FileWriter(filename)) {
            // 写入第一行：学生信息标题
            writer.write("姓名\t年龄\t成绩\n");
            
            // 写入第一条记录
            writer.write("张三\t18\t95\n");
            
            // 写入第二条记录
            writer.write("李四\t17\t88\n");
            
            // 写入第三条记录
            writer.write("王五\t19\t92\n");

            System.out.println("数据已成功写入到 " + filename);

        } catch (IOException e) {
            // 捕获可能的异常，比如文件路径不存在或权限不足
            System.err.println("文件写入失败：" + e.getMessage());
        }
    }
}

代码注释说明：

• FileWriter writer = new FileWriter(filename)：创建 FileWriter 对象，连接到指定文件。如果文件不存在，会自动创建。
• writer.write(...)：将字符串内容写入文件。注意，write() 方法不会自动换行，需要手动添加 \n。
• try-with-resources：确保资源在使用后自动关闭，是 Java 7 以后推荐的最佳实践，避免忘记关闭流导致资源泄漏。
• 异常处理：IOException 可能由磁盘满、文件被占用、路径权限不足等原因引发，必须妥善处理。

运行这段代码后，你会在项目根目录下看到一个 students.txt 文件，内容如下：

姓名	年龄	成绩
张三	18	95
李四	17	88
王五	19	92

使用 BufferedWriter 提升写入性能

FileWriter 虽然简单，但每次调用 write() 都会直接与磁盘交互，效率较低。尤其在写大量数据时，频繁的 I/O 操作会拖慢程序。

这时我们可以引入 BufferedWriter，它在内存中建立一个缓冲区，先将数据暂存，等到缓冲区满或手动刷新时才一次性写入磁盘。这就像快递员不是每次送一件包裹就跑一趟，而是攒够一车再出发，大大提升了效率。

import java.io.BufferedWriter;
import java.io.FileWriter;
import java.io.IOException;

public class BufferedFileWriteExample {
    public static void main(String[] args) {
        String filename = "scores.txt";

        // 使用 BufferedWriter 包装 FileWriter，提升性能
        try (BufferedWriter writer = new BufferedWriter(new FileWriter(filename))) {
            // 写入表头
            writer.write("学生\t语文\t数学\t英语");
            writer.newLine(); // 等价于写入 "\n"，但更清晰

            // 写入多条记录
            writer.write("小明\t85\t90\t88");
            writer.newLine();

            writer.write("小红\t92\t87\t95");
            writer.newLine();

            writer.write("小刚\t78\t83\t80");
            writer.newLine();

            // 手动刷新缓冲区，确保数据写入磁盘
            writer.flush();

            System.out.println("数据已写入 " + filename + "，性能更优。");

        } catch (IOException e) {
            System.err.println("写入失败：" + e.getMessage());
        }
    }
}

关键点说明：

• new BufferedWriter(new FileWriter(...))：将 FileWriter 包装进 BufferedWriter，启用缓冲机制。
• writer.newLine()：推荐使用这个方法代替直接写 \n，因为它会根据操作系统自动选择换行符（Windows 用 \r\n，Linux 用 \n）。
• writer.flush()：强制将缓冲区中的数据写入磁盘。虽然 try-with-resources 会自动关闭流并刷新，但在某些场景下手动刷新更安全。

使用 Files.write() 简化文件操作（Java 7+）

Java 7 引入了 java.nio.file.Files 工具类，提供了更简洁的静态方法来读写文件。Files.write() 是其中最常用的之一，特别适合处理小文件或简单场景。

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardOpenOption;
import java.util.List;

public class FilesWriteExample {
    public static void main(String[] args) {
        // 定义文件路径
        Path path = Paths.get("log.txt");

        // 准备要写入的数据
        List<String> lines = List.of(
            "2024-04-05 10:23:15 - 系统启动",
            "2024-04-05 10:23:18 - 用户登录成功",
            "2024-04-05 10:23:22 - 数据保存完成"
        );

        try {
            // 使用 StandardOpenOption.APPEND 追加写入，避免覆盖原有内容
            Files.write(path, lines, StandardOpenOption.CREATE, StandardOpenOption.APPEND);

            System.out.println("日志已成功写入 " + path);

        } catch (IOException e) {
            System.err.println("文件写入失败：" + e.getMessage());
        }
    }
}

优势解析：

• Files.write() 可以一次性写入整个字符串列表，代码更简洁。
• StandardOpenOption.CREATE：如果文件不存在则创建。
• StandardOpenOption.APPEND：以追加模式写入，不会覆盖原内容。这是日志文件的常见需求。
• 无需手动创建流、关闭资源，自动管理。

实际应用场景：生成报表文件

让我们看一个更贴近实际的 Java 实例 – 文件写入 案例：生成月度销售报表。

import java.io.BufferedWriter;
import java.io.FileWriter;
import java.io.IOException;
import java.time.LocalDate;
import java.util.Map;
import java.util.TreeMap;

public class SalesReportGenerator {
    public static void generateReport(Map<String, Double> salesData) {
        String filename = "sales_report_" + LocalDate.now() + ".csv";

        try (BufferedWriter writer = new BufferedWriter(new FileWriter(filename))) {
            // 写入表头
            writer.write("产品,销售额(元)");
            writer.newLine();

            // 按产品名称排序输出（TreeMap 保证有序）
            for (Map.Entry<String, Double> entry : new TreeMap<>(salesData).entrySet()) {
                writer.write(entry.getKey() + "," + entry.getValue());
                writer.newLine();
            }

            System.out.println("销售报表已生成：" + filename);

        } catch (IOException e) {
            System.err.println("生成报表失败：" + e.getMessage());
        }
    }

    public static void main(String[] args) {
        // 模拟销售数据
        Map<String, Double> data = new TreeMap<>();
        data.put("iPhone 15", 125000.0);
        data.put("iPad Pro", 89000.0);
        data.put("AirPods", 45000.0);
        data.put("Apple Watch", 78000.0);

        generateReport(data);
    }
}

运行后生成的 sales_report_2024-04-05.csv 文件内容：

产品,销售额(元)
AirPods,45000.0
Apple Watch,78000.0
iPad Pro,89000.0
iPhone 15,125000.0

这个案例展示了如何将业务数据转化为结构化文件，适用于导出、审计、系统对接等场景。

常见问题与最佳实践总结

最佳实践建议：

• 小文件推荐使用 Files.write()，代码简洁。
• 大文件或频繁写入，优先使用 BufferedWriter。
• 一定要使用 try-with-resources 管理资源。
• 写入前检查目录是否存在，必要时创建。
• 使用 StandardOpenOption.APPEND 实现日志追加。

结语

Java 实例 – 文件写入 不仅是语法练习，更是构建可靠应用的基础能力。从 FileWriter 的入门，到 BufferedWriter 的性能优化，再到 Files.write() 的现代化写法，每一步都在提升你的工程素养。

掌握这些技巧后，你不仅能写出能运行的代码，更能写出健壮、高效、可维护的程序。无论是写日志、存数据，还是生成报告，文件写入都将成为你手中的一把利器。

记住：代码写得再好，数据没保存，一切归零。从今天开始，让每一次运行都留下痕迹。