Java文件操作实战：NIO.2与传统IO的常见用法与避坑

注意几点：

• 路径分隔符用 Paths.get("a", "b", "c.txt") 拼接，系统会自动处理斜杠，不用关心 Windows 还是 Linux。
• 文件操作几乎必然抛 IOException，记得捕获或抛出。
• NIO 的 delete 也只能删除空目录，如果目录里还有东西，得先递归删掉子文件。

文本文件读取

读取配置文件、日志这些太常用了。小文件我习惯直接用 Files.readAllLines，一行代码搞定，但要记得指定编码。如果文件可能比较大，就换成逐行读，后面会说。

import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.List;

public class FileReadExample {
    public static void main(String[] args) {
        String filePath = "read_test.txt";
        // 一次性读所有行
        try {
            List<String> lines = Files.readAllLines(Paths.get(filePath), StandardCharsets.UTF_8);
            for (String line : lines) {
                System.out.println(line);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        // 或者读成字节数组
        try {
            byte[] content = Files.readAllBytes(Paths.get(filePath));
            String str = new String(content, StandardCharsets.UTF_8);
            System.out.println("\n完整内容：\n" + str);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

编码一定记得传 StandardCharsets.UTF_8，不然在 Windows 上运行很可能中文乱码。readAllLines 和 readAllBytes 会把整个文件塞进内存，几十 MB 以内问题不大，再大的文件就得上流了。

文本文件写入

写入分覆盖和追加，Files.write 默认是覆盖，加个 StandardOpenOption.APPEND 就是追加。

import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.Arrays;
import java.util.List;

public class FileWriteExample {
    public static void main(String[] args) {
        String filePath = "write_test.txt";
        List<String> content = Arrays.asList("Java 文件操作", "作者：示例", "时间：2026");
        try {
            // 覆盖写入
            Files.write(Paths.get(filePath), content, StandardCharsets.UTF_8);
            System.out.println("覆盖写入成功");
            // 追加写入
            List<String> appendContent = Arrays.asList("", "——追加的内容");
            Files.write(
                Paths.get(filePath),
                appendContent,
                StandardCharsets.UTF_8,
                java.nio.file.StandardOpenOption.APPEND
            );
            System.out.println("追加写入成功");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

遍历目录

有时需要批量处理某个文件夹下的所有文件，比如统计日志数量、转换格式等。Files.walk 会递归遍历子目录，再用 stream 过滤一下很方便。

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.stream.Stream;

public class DirectoryTraverseExample {
    public static void main(String[] args) {
        String dirPath = "testDir";
        try (Stream<Path> walk = Files.walk(Paths.get(dirPath))) {
            walk.filter(Files::isRegularFile)
                .filter(path -> path.toString().endsWith(".txt"))
                .forEach(path -> System.out.println("找到 txt 文件：" + path.toAbsolutePath()));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

注意 Files.walk 返回的 Stream 要放在 try-with-resources 里，否则目录流不会自动关闭，可能造成资源泄露。

大文件读写的处理

别一上来就用 readAllLines 去啃几百 MB 的文件，内存扛不住。下面是用 BufferedReader 和 BufferedWriter 逐行复制大文件的例子，内存占用很低。

import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

public class BigFileOperation {
    public static void main(String[] args) {
        String srcPath = "big_file.txt";
        String destPath = "copy_big_file.txt";
        try (BufferedReader br = Files.newBufferedReader(Paths.get(srcPath), StandardCharsets.UTF_8);
             BufferedWriter bw = Files.newBufferedWriter(Paths.get(destPath), StandardCharsets.UTF_8)) {
            String line;
            while ((line = br.readLine()) != null) {
                // 可以在这里做行级处理，比如过滤或替换
                bw.write(line);
                bw.newLine();
            }
            System.out.println("大文件复制完成");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

常见坑点

实际写代码时，这几个问题我遇到得比较多：

• 中文乱码：读写操作不传 Charset，默认用系统编码，Windows 上 GBK，Linux 上 UTF-8，一跨平台就乱。统一 StandardCharsets.UTF_8 能解决。
• 路径问题：直接写 "C:\\test.txt" 这样的字符串，换个系统就跪。用 Paths.get 动态拼接，或者至少用相对路径。
• 资源释放：传统 IO 的 FileInputStream 之类的忘关，文件可能一直被占用。尽量用 try-with-resources，它会自动 close。
• 目录删除失败：Files.delete 或 File.delete 都要求目录为空。如果目录非空，得自己递归删文件，或者用一些工具库。
• 大文件 OOM：一次性读取整个文件内容，超过堆内存就会 OutOfMemoryError。判断文件大小，超过几十 MB 就换流处理。

几句总结

上面这些内容基本能应付 Java 文件操作的大部分日常需求。NIO.2 的 Paths 和 Files 用起来很顺手，在没有历史包袱的项目里优先考虑。传统 IO 的写法也了解一些，遇到老代码能看懂、能改就行。

如果需要处理二进制文件（如图片、视频）或者文件的复制移动、属性修改，可以留言，后续我会补上对应示例。有错误欢迎指出。