Java 实例 – 文件写入（手把手讲解）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

Java 实例 – 文件写入：从基础到实践的全面解析

在编程开发中，文件操作是一项核心技能。无论是记录系统日志、存储用户数据，还是生成配置文件，文件写入功能都是开发者必须掌握的基础技术之一。本文将以“Java 实例 – 文件写入”为主题，通过循序渐进的讲解和代码示例，帮助编程初学者和中级开发者快速掌握这一技能。

一、为什么需要文件写入？

文件写入是程序与外部世界交互的重要方式。想象一下，一个在线购物系统在用户下单后需要记录订单信息，或者一个数据分析工具需要将处理后的结果保存为文本文件——这些场景都离不开文件写入技术。通过文件写入，程序可以将内存中的数据持久化存储，确保数据在程序关闭后依然可用。

二、Java 文件写入的基础方法

1. 使用 FileWriter 和 BufferedWriter

Java 标准库提供了多个类来实现文件写入功能。FileWriter 是最基础的写入类，但直接使用它可能会有性能问题。因此，通常会结合 BufferedWriter 来提升效率。

比喻：可以将 FileWriter 比作直接用手搬运沙子，每次只能拿一粒；而 BufferedWriter 则像用铲子和桶，通过缓冲区一次性搬运大量沙子，速度更快。

代码示例：

import java.io.*;  

public class FileWriterExample {  
    public static void main(String[] args) {  
        String filePath = "output.txt";  
        try (BufferedWriter writer = new BufferedWriter(new FileWriter(filePath))) {  
            writer.write("Hello, this is a test line.");  
            writer.newLine();  
            writer.write("Second line of text.");  
        } catch (IOException e) {  
            e.printStackTrace();  
        }  
    }  
}  

2. 使用 PrintWriter

PrintWriter 提供了更灵活的写入方式，支持直接打印字符串、数字等类型，并且可以自动处理换行符。

代码示例：

import java.io.*;  

public class PrintWriterExample {  
    public static void main(String[] args) {  
        String filePath = "output.txt";  
        try (PrintWriter writer = new PrintWriter(new FileWriter(filePath))) {  
            writer.println("Print with automatic newline");  
            writer.printf("Formatted text: %d", 42); // 使用格式化输出  
        } catch (IOException e) {  
            e.printStackTrace();  
        }  
    }  
}  

3. 字节流与字符流的区别

Java 中的文件操作分为字节流（如 FileOutputStream）和字符流（如 FileWriter）。字符流专门处理文本数据，会自动处理不同平台的编码问题，因此在写入文本时推荐使用字符流。

三、进阶方法：NIO 的 Files.write 和 Path

Java 7 引入了 NIO.2（New Input/Output）包，提供了更简洁的 API。例如，Files.write 方法可以一次性将字符串写入文件，并自动管理资源。

代码示例：

import java.nio.file.*;  
import java.nio.charset.StandardCharsets;  

public class NIOExample {  
    public static void main(String[] args) {  
        Path path = Paths.get("output.txt");  
        String content = "Using NIO for simplicity";  
        try {  
            Files.write(path, content.getBytes(StandardCharsets.UTF_8));  
        } catch (IOException e) {  
            e.printStackTrace();  
        }  
    }  
}  

四、异常处理与资源管理

文件写入操作可能因权限不足、磁盘空间不足等原因失败，因此必须妥善处理异常。

1. try-with-resources 语句

Java 7 引入的 try-with-resources 可以确保资源（如 BufferedWriter）在操作完成后自动关闭，避免资源泄漏。

代码示例：

try (BufferedWriter writer = new BufferedWriter(new FileWriter("output.txt"))) {  
    // 写入代码  
} catch (IOException e) {  
    // 异常处理  
}  

2. 自定义异常处理逻辑

对于关键操作，可以捕获 IOException 并记录详细信息，例如：

catch (IOException e) {  
    System.err.println("Error writing to file: " + e.getMessage());  
    // 可能需要回滚操作或通知用户  
}  

五、性能优化与最佳实践

1. 缓冲区的使用

通过 BufferedWriter 或 OutputStreamWriter 的缓冲区，可以显著提升写入速度。例如，写入 1000 条记录时，使用缓冲区比直接写入快数十倍。

2. 批量写入 vs 单条写入

频繁的小写入操作（如每条数据单独写入）会增加磁盘 I/O 负担。建议将数据收集到内存缓冲区，达到一定量后再批量写入。

代码示例（批量写入）：

List<String> lines = new ArrayList<>();  
// 添加数据到 lines  
try (BufferedWriter writer = new BufferedWriter(new FileWriter("output.txt"))) {  
    for (String line : lines) {  
        writer.write(line);  
        writer.newLine();  
    }  
}  

六、实际案例：日志记录系统

假设要开发一个简单的日志记录工具，要求将日志信息追加到文件末尾，并添加时间戳。

代码实现：

import java.io.*;  
import java.time.LocalDateTime;  
import java.time.format.DateTimeFormatter;  

public class Logger {  
    private static final String LOG_FILE = "app.log";  

    public static void log(String message) {  
        try (BufferedWriter writer = new BufferedWriter(new FileWriter(LOG_FILE, true))) {  
            String timestamp = LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME);  
            writer.write(timestamp + " - " + message);  
            writer.newLine();  
        } catch (IOException e) {  
            System.err.println("Logging failed: " + e.getMessage());  
        }  
    }  

    public static void main(String[] args) {  
        log("Application started");  
        log("Processing user request");  
    }  
}  

案例分析

• 追加模式：通过 FileWriter 的构造函数参数 true 实现追加写入。
• 时间戳生成：使用 LocalDateTime 和格式化类确保日志时间的可读性。

七、常见问题与解决方案

1. 文件路径问题

• 相对路径 vs 绝对路径：若文件路径错误，可能导致 FileNotFoundException。建议使用绝对路径或通过 Paths.get() 检查路径是否存在。
• 跨平台路径：使用 File.separator 或 Path 类避免不同操作系统路径分隔符的差异。

2. 编码问题

默认情况下，FileWriter 使用平台默认编码（如 Windows 的 Cp1252）。若需指定编码（如 UTF-8），可以通过构造函数传递 Charset：

FileWriter writer = new FileWriter("output.txt", StandardCharsets.UTF_8);  

八、对比与选择：不同写入方式的优缺点

以下表格总结了常见写入方法的特点：

九、进阶技巧：异步写入与线程安全

对于高并发场景（如服务器日志），可以结合线程池实现异步写入：

代码示例：

ExecutorService executor = Executors.newSingleThreadExecutor();  
executor.submit(() -> {  
    try (BufferedWriter writer = new BufferedWriter(new FileWriter("async.log", true))) {  
        writer.write("Asynchronous log entry");  
    } catch (IOException e) {  
        e.printStackTrace();  
    }  
});  

十、结论与展望

通过本文的讲解，读者可以掌握从基础到进阶的 Java 文件写入方法，并了解如何结合实际需求选择最优方案。随着 Java 17 的 Structured concurrency 等新特性引入，文件操作的并行化和资源管理将进一步简化。建议开发者在实践中多尝试不同方法，结合性能测试工具（如 JMH）优化代码。

最后提醒：在生产环境中，务必通过日志框架（如 Log4j）或成熟的库（如 Apache Commons IO）来处理复杂场景，避免重复造轮子。掌握“Java 实例 – 文件写入”的核心逻辑后，开发者可以更自信地应对实际项目中的数据持久化需求。