Java文件读写基础项目实战解析

Java文件读写的核心难点不在于语法本身，而在于根据实际场景精准选择API与处理策略：小文件优先用简洁安全的Files工具类（但必须显式指定UTF-8等Charset以防跨平台乱码），大文件或流式处理则必须采用带缓冲的InputStream/OutputStream组合，并严格使用try-with-resources避免资源泄漏；文本操作绝不能依赖过时的FileReader/FileWriter，而应通过InputStreamReader/OutputStreamWriter明确编码；异常处理更要分级捕获——区分AccessDeniedException、SecurityException等具体子类，而非笼统catch IOException。真正决定项目稳健性的，是开发者对文件大小、编码控制、IO中断需求和错误响应粒度的综合判断力。

Java 中完成文件读写，核心不是选 API，而是分清场景：小文件直接用 Files，大文件或需控制流必须用 InputStream/OutputStream，混用字符编码（如中文）不指定 Charset 必出乱码。

小文件读写优先用 Files 工具类

适合配置文件、日志片段、JSON 文本等几 MB 以内的内容。它封装了底层流，一行代码就能搞定，但会把整个文件加载进内存，别用它读 GB 级日志。

常见写法：

String content = "Hello 世界";
Files.write(Paths.get("output.txt"), content.getBytes(StandardCharsets.UTF_8));

读取时务必显式传 StandardCharsets.UTF_8，否则 Windows 上默认 GBK，Linux/macOS 默认 UTF-8，跨平台必崩：

String text = Files.readString(Paths.get("input.txt"), StandardCharsets.UTF_8);

• Files.readAllLines() 返回 List，每行自动去 \r\n
• Files.write() 默认覆盖，加 StandardOpenOption.APPEND 才追加
• 路径不存在会抛 NoSuchFileException，父目录不存在则抛 IOException，得提前 Files.createDirectories()

大文件或逐块处理必须用 BufferedInputStream/BufferedOutputStream

读 GB 日志、传输视频、解析 CSV 流时，不能全载入内存。FileInputStream 和 FileOutputStream 没缓冲区，单字节读写极慢，必须套一层 Buffered 类。

示例：复制大文件

try (var in = new BufferedInputStream(new FileInputStream("a.zip"));
     var out = new BufferedOutputStream(new FileOutputStream("b.zip"))) {
    byte[] buf = new byte[8192];
    int len;
    while ((len = in.read(buf)) != -1) {
        out.write(buf, 0, len);
    }
}

• 缓冲区大小设 8192 是经验值，太小频繁系统调用，太大无意义
• 务必用 try-with-resources，否则流不关会导致句柄泄漏
• FileInputStream 读的是原始字节，不处理编码；要读文本还得包 InputStreamReader

读写文本文件别直接用 FileReader/FileWriter

这两个类默认使用平台编码，且不支持指定 Charset，是历史遗留坑。Java 11 后已标记为“legacy”，文档明确建议用 InputStreamReader + FileInputStream 替代。

正确做法：

try (var reader = new BufferedReader(
        new InputStreamReader(
            new FileInputStream("data.txt"), StandardCharsets.UTF_8))) {
    String line;
    while ((line = reader.readLine()) != null) {
        System.out.println(line);
    }
}

• BufferedReader.readLine() 自动处理 \n、\r\n、\r
• FileWriter 的 append 构造参数仅控制是否追加，跟编码无关
• 写文本推荐 Files.write() 或 BufferedWriter + OutputStreamWriter

异常处理不能只 catch IOException

Files 方法抛 IOException，但底层可能触发 SecurityException（沙箱环境）、AccessDeniedException（权限不足）、AtomicMoveNotSupportedException（跨文件系统移动失败）。生产代码里至少得区分 AccessDeniedException 和其他 IO 错误。

典型模式：

try {
    Files.copy(src, dst, StandardCopyOption.REPLACE_EXISTING);
} catch (AccessDeniedException e) {
    logger.error("无权访问: {}", e.getFile(), e);
} catch (IOException e) {
    logger.error("IO 失败: {}", dst, e);
}

• Files 抛的异常是具体子类，可直接 instanceof 判断
• Windows 下对正在被记事本打开的文件执行 Files.delete() 会抛 AccessDeniedException，不是 IOException
• 不要用 throws Exception 一揽子抛出，调用方无法针对性处理

真正难的从来不是“怎么写”，而是判断该用哪条路：文件大小、是否需要中断/跳转、编码是否可控、异常是否要分级响应——这些决策点比语法细节重要得多。

本篇关于《Java文件读写基础项目实战解析》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！