文件是 IO 流乃至多线程的基础，学好文件这一板块可以为我们后续进一步学习 IO 流和多线程打下坚实的基础。在 Java 开发中，文件操作是高频且基础的核心技能 —— 无论是读取配置文件、生成日志、导出报表，还是处理用户上传的文件，都离不开对文件的创建、读取、写入、删除等操作。本文将从「实用场景」出发，手把手教你掌握 Java 文件操作的核心方法，从传统 IO 到 NIO.2，兼顾基础与最佳实践，新手也能快速上手。
一、前置知识：Java 文件操作的核心 API
Java 提供了两套核心文件操作体系，我们先理清它们的定位，避免用错工具：
| 体系 | 核心包 / 类 | 特点 | 适用场景 |
|---|---|---|---|
| 传统 IO | java.io.File、FileReader、FileWriter | 兼容性好，API 偏底层 | 简单文件操作、兼容老项目 |
| NIO.2 | java.nio.file（Paths、Files） | Java 7 新增，API 简洁、功能强、效率高 | 新项目优先使用，支持批量操作、文件属性管理 |
本文以NIO.2为主（推荐），同时补充传统 IO 的核心用法，满足不同场景需求。
二、实战：文件操作核心场景（附完整代码）
所有示例代码均可直接复制到 IDE 中运行，建议先创建测试目录 / 文件，跟着步骤实操。
场景 1：基础操作（创建、删除、判断文件 / 目录）
这是文件操作的「基本功」，比如创建配置文件、判断文件是否存在、删除临时文件等。
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class FileBasicOperations {
public static void main(String[] args) {
// ========== 1. 传统 IO（File 类） ==========
// 定义文件路径：Windows 用\\（转义）或/，Linux/Mac 用/
File file = new File("test.txt");
try {
// 创建文件（不存在则创建，存在则返回 false）
if (file.createNewFile()) {
System.out.println("文件创建成功：" + file.getAbsolutePath());
} else {
System.out.println("文件已存在");
}
// 核心判断：文件/目录类型
System.out.println("是否是文件：" + file.isFile());
System.out.println("是否是目录：" + file.isDirectory());
// 创建目录：mkdir（单层）、mkdirs（多层，推荐）
File dir = new File("testDir/subDir");
if (dir.mkdirs()) {
System.out.println("多层目录创建成功：" + dir.getAbsolutePath());
}
// 删除文件/目录（目录需为空才能删除）
if (file.delete()) {
System.out.println("文件删除成功");
}
} catch (Exception e) {
e.printStackTrace(); // 捕获 IO 异常（权限不足、路径不存在等）
}
// ========== 2. NIO.2（推荐） ==========
Path path = Paths.get("test_nio.txt");
try {
// 创建文件（先判断是否存在，避免重复创建）
if (!Files.exists(path)) {
Files.createFile(path);
System.out.println("NIO 创建文件成功：" + path.toAbsolutePath());
}
// 创建多层目录（无需区分单层/多层）
Path dirPath = Paths.get("testDirNio/subDir");
if (!Files.exists(dirPath)) {
Files.createDirectories(dirPath);
System.out.println("NIO 创建目录成功");
}
// 删除文件/目录（支持非空目录？不，需手动遍历删除子文件）
if (Files.exists(path)) {
Files.delete(path);
System.out.println("NIO 删除文件成功");
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
关键说明：
- 路径适配：推荐用
Paths.get("目录", "子目录", "文件.txt")，自动适配不同系统的分隔符； - 异常处理：文件操作必然涉及 IO 异常，必须捕获或声明抛出；
- 目录删除：
delete()只能删除空目录，非空目录需先遍历删除子文件 / 子目录。
场景 2：文本文件读取（最常用）
读取配置文件、日志文件、用户上传的文本等，NIO.2 的 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";
// 先创建该文件并写入测试内容
// 方式 1：一次性读取所有行（推荐，简洁）
try {
// 指定 UTF-8 编码，避免中文乱码
List<String> lines = Files.readAllLines(Paths.get(filePath), StandardCharsets.UTF_8);
for (String line : lines) {
System.out.println("读取到行：" + line);
}
} catch (Exception e) {
e.printStackTrace();
}
// 方式 2：读取为字节数组（兼容文本/二进制文件）
try {
byte[] content = Files.readAllBytes(Paths.get(filePath));
String contentStr = new String(content, StandardCharsets.UTF_8);
System.out.println("完整内容：\n" + contentStr);
} catch (Exception e) {
e.printStackTrace();
}
}
}
关键说明：
- 编码指定：必须显式指定
StandardCharsets.UTF_8，否则会使用系统默认编码，导致中文乱码； - 大文件注意：
readAllLines/readAllBytes适合小文件（几十 MB 内），大文件需用流逐行读取（下文补充）。
场景 3：文本文件写入（覆盖 / 追加）
生成日志、导出数据、写入配置等场景，核心是「覆盖写入」和「追加写入」。
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 {
// 方式 1：覆盖写入（文件不存在则创建，存在则清空原有内容）
Files.write(Paths.get(filePath), content, StandardCharsets.UTF_8);
System.out.println("覆盖写入成功");
// 方式 2：追加写入（保留原有内容，在末尾添加）
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();
}
}
}
场景 4：遍历目录下的所有文件
比如批量处理某目录下的所有 Excel 文件、统计日志文件数量等，NIO.2 的 Files.walk 非常高效。
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")) // 筛选 txt 文件
.forEach(path -> System.out.println("符合条件的文件：" + path.toAbsolutePath()));
} catch (Exception e) {
e.printStackTrace();
}
}
}
扩展：大文件读写（避免内存溢出）
如果文件大小超过 100MB，不能用 readAllLines 一次性读取，需用「流」逐行处理：
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();
}
}
}
三、避坑指南：新手常犯的错误
- 中文乱码：未指定编码，默认使用系统编码（Windows 是 GBK，Linux 是 UTF-8），解决：所有读写操作显式指定
StandardCharsets.UTF_8； - 路径错误：硬编码 Windows 路径（如
C:\\test.txt），Linux 下运行报错，解决：用Paths.get("C:", "test.txt")适配系统； - 资源未关闭：传统 IO 的
FileInputStream未关闭导致文件被占用，解决：用try-with-resources语法（自动关闭资源）； - 权限问题：写入系统目录（如 C 盘根目录）报错，解决：选择有写入权限的目录（如项目根目录、用户目录）。
四、总结
- Java 文件操作优先使用
java.nio.file（NIO.2），API 简洁且效率高，核心类是Paths（路径）和Files（操作）； - 小文件用
readAllLines/write一次性处理，大文件用BufferedReader/BufferedWriter逐行处理； - 所有文件操作必须处理 IO 异常，显式指定 UTF-8 编码，避免乱码和兼容性问题。
掌握以上内容，你就能应对 90% 的 Java 文件操作场景。如果需要处理二进制文件（如图片、视频）、文件复制 / 移动、文件属性修改等进阶操作，可在评论区留言，后续会补充对应的示例。文章如有错误欢迎私信我，我会及时解决。
