Java 实例 – 向文件中追加数据（长文讲解）

Java 实例 – 向文件中追加数据：从基础到实战

在日常开发中，我们经常需要将程序运行时的日志、用户操作记录、调试信息等数据保存到文件中。如果只是简单地写入一次，用 FileWriter 就够了。但当我们要持续记录数据，比如每天记录用户登录行为，或者监控系统运行状态，就需要“追加”模式——即不覆盖原文件内容，而是在文件末尾继续添加新内容。

这就是今天我们要深入探讨的主题：Java 实例 – 向文件中追加数据。无论你是刚接触 Java 的初学者，还是已经有一定经验的中级开发者，这篇文章都会帮你彻底搞懂这个常用但容易出错的功能。

为什么需要“追加”而不是“覆盖”？

想象一下你正在写一本日记。如果你每天写完都把前一天的内容删掉，那还叫“日记”吗？显然不是。我们真正想要的是“不断添加”，而不是“替换”。

在程序开发中也是如此。比如一个日志系统，每天都会生成新的日志条目。如果每次运行都覆盖原文件，那昨天的记录就全没了，这显然不符合实际需求。

Java 提供了 FileWriter 的一个构造函数参数，可以轻松实现“追加”功能，而无需手动读取原文件再写入。

使用 FileWriter 实现追加写入

Java 的 FileWriter 类是处理文件写入的核心类之一。默认情况下，它会覆盖原有文件内容。但只要在构造函数中传入 true 参数，就可以开启“追加”模式。

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

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

        // 使用 FileWriter 构造函数的第二个参数 true，开启追加模式
        try (FileWriter writer = new FileWriter(filePath, true)) {
            // 写入一条日志信息，末尾加换行符
            writer.write("【2025-04-05 10:30:00】用户登录成功\n");
            writer.write("【2025-04-05 10:31:15】用户访问首页\n");

            // 写入完成后自动刷新缓冲区
            writer.flush();

            System.out.println("数据已成功追加到文件中。");
        } catch (IOException e) {
            // 捕获可能的文件操作异常
            System.err.println("文件写入失败：" + e.getMessage());
        }
    }
}

代码详解：

• new FileWriter(filePath, true)：这里的 true 就是关键！它告诉 Java：不要覆盖文件，而是从文件末尾开始写。
• try-with-resources 语法：自动关闭资源，避免内存泄漏，是现代 Java 推荐写法。
• writer.write()：写入字符串内容，注意加上 \n 换行符，让每条记录独立成行。
• writer.flush()：强制将缓冲区中的数据写入磁盘，确保数据不丢失。

💡 提示：如果没有调用 flush()，在某些情况下数据可能滞留在内存缓冲区，不会立即写入文件。

与 BufferedWriter 配合使用更高效

当你要写入大量数据时，频繁调用 FileWriter.write() 会带来性能瓶颈，因为每次写操作都可能触发一次磁盘 I/O。这时，我们可以引入 BufferedWriter，它会先将数据缓存在内存中，等缓冲区满了再一次性写入，大幅提升效率。

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

public class BufferedAppendExample {
    public static void main(String[] args) {
        String filePath = "events.log";

        try (BufferedWriter writer = new BufferedWriter(new FileWriter(filePath, true))) {
            // 一次性写入多条记录
            writer.write("【系统启动】服务初始化完成");
            writer.newLine(); // 等价于写入 \n，更清晰

            writer.write("【用户注册】新用户 ID: U1001");
            writer.newLine();

            writer.write("【订单创建】订单号: O98765");
            writer.newLine();

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

            System.out.println("批量数据已成功追加。");
        } catch (IOException e) {
            System.err.println("写入失败：" + e.getMessage());
        }
    }
}

关键点说明：

• BufferedWriter 是 FileWriter 的“升级版”，自带缓冲区。
• newLine() 方法比手动写 \n 更安全，因为它会根据操作系统自动选择换行符（Windows 是 \r\n，Linux/Mac 是 \n）。
• 仍然使用 true 参数开启追加模式，与 FileWriter 保持一致。

实际应用场景：日志记录系统

让我们来模拟一个真实的场景：一个简单的用户操作日志系统。

import java.io.BufferedWriter;
import java.io.FileWriter;
import java.io.IOException;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class UserActionLogger {
    private final String logFile = "user_actions.log";
    private final DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    // 记录用户操作的方法
    public void logAction(String userName, String action) {
        String timestamp = LocalDateTime.now().format(formatter);
        String logEntry = String.format("【%s】用户: %s 执行了: %s", timestamp, userName, action);

        try (BufferedWriter writer = new BufferedWriter(new FileWriter(logFile, true))) {
            writer.write(logEntry);
            writer.newLine();
            writer.flush(); // 确保写入
        } catch (IOException e) {
            System.err.println("日志写入失败：" + e.getMessage());
        }
    }

    public static void main(String[] args) {
        UserActionLogger logger = new UserActionLogger();

        // 模拟用户行为
        logger.logAction("张三", "登录系统");
        logger.logAction("李四", "修改个人资料");
        logger.logAction("王五", "提交订单");

        System.out.println("用户操作日志已记录。");
    }
}

输出示例（log 文件内容）：

【2025-04-05 10:45:23】用户: 张三 执行了: 登录系统
【2025-04-05 10:45:25】用户: 李四 执行了: 修改个人资料
【2025-04-05 10:45:27】用户: 王五 执行了: 提交订单

这个例子展示了如何将“追加写入”融入实际业务逻辑中，结构清晰，可复用性强。

常见问题与注意事项

⚠️ 特别提醒：在生产环境中，建议使用 java.nio.file.Files 提供的 API，比如 Files.write() 配合 StandardOpenOption.APPEND，更现代、更安全。

小结：掌握“追加写入”的核心要点

• 使用 FileWriter(filePath, true) 是实现追加写入的最简单方式。
• BufferedWriter 可显著提升性能，尤其在大量写入时。
• 始终使用 try-with-resources 确保资源释放。
• 一定要调用 flush()，避免数据丢失。
• 在真实项目中，考虑使用 Files.write() + APPEND 选项，代码更简洁且更现代。

Java 实例 – 向文件中追加数据 不仅是基础 IO 操作，更是构建日志系统、数据采集、审计记录等模块的基石。掌握它，意味着你已经迈出了构建健壮应用的第一步。

无论你是初学者，还是希望夯实基础的中级开发者，只要动手实践一遍，就会发现，看似简单的操作背后，藏着丰富的设计思想与最佳实践。多写、多试、多调试，才是提升编程能力的正道。