在Java标准库中，java.nio.file.Files类为文件和目录操作提供了一套统一、简洁的静态方法。它以NIO中的Path接口为核心，屏蔽了底层文件系统的差异，使开发者不必手动包装FileInputStream或FileOutputStream。无论是读取配置文件、写入运行日志，还是批量处理目录树，Files类都能用少量代码完成常见任务。本文将围绕路径定位、文本读取、写入复制、目录遍历以及异常排查几个维度展开说明。
一、使用Path定位文件与基础状态判断
使用Files之前必须先获得Path对象。Paths.get是最常用的入口，它接受字符串或URI，并按照当前系统规则拼接路径。Windows与Linux下的路径分隔符不同，但Path会自动归一化处理，避免硬编码反斜杠带来的移植问题。开发者可以传入多个路径片段，由系统自动组合成合法路径。
拿到Path之后，往往需要先做前置校验。Files.exists和Files.isRegularFile能够判断路径是否存在以及是否为普通文件。与旧版File类不同，这些方法支持LinkOption参数。例如传入LinkOption.NOFOLLOW_LINKS可以禁止跟随符号链接，在安全扫描、备份校验等场景中能够减少误判，使判断结果更贴近真实文件系统状态。
下面的示例演示了如何创建Path对象并进行基础判断，重点关注不跟随符号链接的场景。
import java.nio.file.*;
import java.nio.file.attribute.*;
public class PathDemo {
public static void main(String[] args) throws Exception {
Path path = Paths.get("/data", "app.log");
// 不跟随符号链接判断是否存在
boolean exists = Files.exists(path, LinkOption.NOFOLLOW_LINKS);
System.out.println("文件存在：" + exists);
// 判断是否为普通文件
boolean isFile = Files.isRegularFile(path);
System.out.println("是普通文件：" + isFile);
}
}
二、文本读取：小文件整读与大文件流式读
Files.readAllLines适合小到中等体积的文本文件，它会一次性读入内存并返回List<String>，编码默认使用UTF-8。这种方法代码最短，适合读取启动配置、属性文件等可控大小的内容。但如果文件达到几百兆级别，一次性载入内存会显著增加堆空间压力，甚至导致内存溢出，因此不建议用于大日志文件。
对于大文件或需要逐行处理的场景，Files.newBufferedReader返回的BufferedReader可以配合try-with-resources自动关闭，既保留流式处理的优势，又不必书写finally块。逐行读取能够及时释放不再需要的数据，并且便于在读取过程中做过滤、统计或提前终止。下面示例同时展示两种读取写法，后者更适合生产环境。
import java.nio.file.*;
import java.io.*;
import java.util.List;
public class ReadDemo {
public static void main(String[] args) throws IOException {
Path p = Paths.get("config.txt");
// 方式一：小文件整读
List<String> lines = Files.readAllLines(p);
lines.forEach(System.out::println);
// 方式二：大文件流式读
try (BufferedReader br = Files.newBufferedReader(p)) {
String line;
while ((line = br.readLine()) != null) {
if (line.contains("error")) {
System.out.println("发现错误行：" + line);
}
}
}
}
}
三、文件写入与复制选项详解
写入文本时，Files.write能够接收Iterable<? extends CharSequence>，这意味着List<String>、数组等常见数据结构都可以直接传入。通过StandardOpenOption可以指定覆盖、追加、新建等行为，避免手动管理文件输出流的打开模式。当需要写入二进制内容时，可以使用Files.copy(InputStream, Path)直接从输入流落地数据，省去手动分配缓冲区并逐段拷贝的步骤。
目录之间迁移文件推荐使用Files.copy(Path, Path, CopyOption...)。传入StandardCopyOption.REPLACE_EXISTING能够在目标已存在时进行覆盖；如果希望移动操作具备原子性，则可以选用ATOMIC_MOVE，避免程序中途崩溃导致只写入一半文件。复制前最好调用Files.createDirectories创建目标父目录，防止因目录不存在而抛出异常。
import java.nio.file.*;
import java.nio.file.attribute.*;
import static java.nio.file.StandardCopyOption.*;
public class CopyDemo {
public static void main(String[] args) throws IOException {
Path src = Paths.get("a.txt");
Path dst = Paths.get("backup/a.txt");
// 确保目标目录存在
Files.createDirectories(dst.getParent());
// 覆盖式复制
Files.copy(src, dst, REPLACE_EXISTING);
System.out.println("复制完成");
}
}
四、递归遍历目录与安全删除策略
Files.walk返回Stream<Path>，能够以深度优先方式遍历目录树，配合filter可以轻松筛选出符合后缀、大小等条件的路径。但Stream不会自动关闭底层目录资源，必须使用try-with-resources包裹。如果忽略这一点，在遍历海量子目录时可能出现系统文件句柄耗尽的问题。
另一个容易出错的地方是在遍历过程中执行删除操作。如果先删除父目录，后续遍历子路径时可能抛出NoSuchFileException。更安全的做法是使用Files.walkFileTree，重写visitFile和postVisitDirectory方法：在进入目录时处理文件，在离开目录后再删除目录自身，这样能够严格保证遍历顺序，避免删除过程中的路径失效。
import java.nio.file.*;
import java.io.IOException;
public class WalkDemo {
public static void main(String[] args) throws IOException {
Path root = Paths.get("logs");
// 必须放在try里以关闭目录流
try (var stream = Files.walk(root)) {
stream.filter(Files::isRegularFile)
.filter(p -> p.toString().endsWith(".tmp"))
.forEach(p -> {
try {
Files.delete(p);
} catch (IOException e) {
e.printStackTrace();
}
});
}
}
}
五、异常排查与权限快速定位
Files类的方法抛出的异常大多是IOException的子类，例如NoSuchFileException、AccessDeniedException等。相比旧File类返回布尔值的做法，这些具体异常能够更清晰地指出失败原因。在运维脚本或监控程序中，应当优先捕获具体子类并给出可读性强的提示，而不是笼统地打印全部堆栈信息。
权限问题常见于容器挂载卷、多用户环境或只读目录。排查时可以先用Files.getPosixFilePermissions读取当前的POSIX权限集合，结合执行用户的身份判断缺失的是读、写还是执行权限。对于不支持POSIX的文件系统，可以使用Files.isWritable做快速写入探测。这样在容器环境出现uid映射导致写入失败时，能够明显缩短排障时间。
import java.nio.file.*;
import java.nio.file.attribute.*;
import java.io.IOException;
import java.util.Set;
public class PermDemo {
public static void main(String[] args) {
Path p = Paths.get("/var/data");
try {
Set<PosixFilePermission> perms = Files.getPosixFilePermissions(p);
System.out.println("权限集合：" + perms);
} catch (AccessDeniedException e) {
System.out.println("无权限访问，请检查挂载或用户组");
} catch (IOException e) {
System.out.println("其他IO错误：" + e.getMessage());
}
}
}
六、总结与选型建议
在Java中进行文件读写与目录操作时，Files类提供了从路径定位、状态判断、内容读取、写入复制到递归遍历的完整方法链。对于几十兆以内的小文件，Files.readAllBytes、Files.readAllLines和Files.write的组合最为省事；对于日志流、导出文件等大体积数据，应优先选择Files.newBufferedReader、Files.newBufferedWriter或Files.newInputStream等流式方法，以避免不必要的内存占用。
目录遍历时必须注意资源关闭：Files.walk返回的Stream<Path>一定要放在try-with-resources中。涉及删除目录的场景则推荐使用walkFileTree或Files.walk配合反向排序删除。对于仅需遍历叶子文件、过滤扩展名、统计目录大小的场景，Files.walk就已经足够；对于需要在访问前后执行额外动作，或者希望在遇到权限错误时继续遍历的场景，Files.walkFileTree的回调机制会更加灵活可控。
除了常规读写之外，还有两点经常被忽略但非常容易踩坑。第一是字符编码：Files.readAllLines和Files.newBufferedReader在没有显式指定Charset时使用UTF-8，但如果源文件是GBK、ISO-8859-1等历史编码，就会出现乱码。建议统一使用StandardCharsets.UTF_8并配合Charset.forName处理遗留文件。第二是文件状态与文件系统的一致性：在分布式挂载、网络文件系统或并发写入的场景下，Files.exists之后立刻打开文件并不代表文件一定可用，因为文件可能在两次调用之间被删除或替换。如果需要更稳健的逻辑，应该直接尝试打开或读取，并通过NoSuchFileException、AccessDeniedException等异常来驱动分支处理，而不是仅依赖预先探测。
最后归纳一下：路径统一用Path，物理操作统一用Files，需要判断属性时配合FileStore和FileSystem；小文件优先用批量读写，大文件优先用流；目录递归要么用try-with-resources包裹Stream，要么用FileVisitor精确控制；删除策略上先处理子目录再处理父目录，同时预留访问失败的回退方案。掌握这些方法之后，Java中的文件处理代码可以从原来大量手写File、FileInputStream、FileOutputStream和递归模板的状态，迁移到更简洁、更可控、也更可读的现代NIO写法。整个文件操作链路从“选择路径”到“执行动作”再到“异常兜底”，都应当围绕Path、Files和FileVisitor这三个核心API来设计，这样才能在跨平台行为、资源释放和错误处理三个维度上获得更好的稳定性。
至此，关于Java使用Files类进行文件读写与目录操作的核心内容就已完整覆盖。实际项目中，只需根据文件大小、并发情况、目录深度和错误容忍度选择合适的API组合，同时始终注意资源关闭和权限异常处理，就可以避免大多数常见文件操作问题。