在Java中Paths和Files类如何使用_Java文件操作新API解析

Paths.get()是构建Path对象的正确入口,应使用可变参数自动适配路径分隔符,避免字符串拼接;Files.exists()等需注意符号链接处理,小文件用readString/writeString,大文件必须用流;walk操作需谨慎处理权限异常。

Java 7 引入的 PathsFiles 是 NIO.2 的核心,替代了老旧的 File 类;它们更安全、功能更强,但不是“语法糖”,用错路径或忽略异常会直接抛 IOExceptionSecurityException

怎么用 Paths.get() 构建正确路径对象

Paths.get() 是入口,它不检查路径是否存在,只解析字符串并返回 Path 实例。常见错误是拼接字符串用 + 或硬写 /,导致跨平台失败(Windows 用 \,Linux/macOS 用 /)。

  • ✅ 正确:用可变参数自动适配分隔符 —— Paths.get("data", "config", "app.json")
  • ❌ 错误:手动拼 "data/config/app.json"(在 Windows 上可能被识别为相对路径但行为异常)
  • ⚠️ 注意:Paths.get("") 返回当前工作目录的 Path,不是空路径;Paths.get("a/b", "..", "c") 会自动归一化为 a/c

Files.exists()Files.isDirectory() 必须配合 LinkOption.NOFOLLOW_LINKS 使用

默认情况下,Files.exists() 会跟随符号链接(symlink),如果目标不存在或权限不足,就返回 false——但这不等于“路径不存在”,可能是链接损坏或无读权限。不加控制容易误判。

  • 查真实存在且可访问:用 Files.exists(path)
  • 查是否为目录(不跟链接):用 Files.isDirectory(path, LinkOption.NOFOLLOW_LINKS)
  • 查是否为符号链接本身:用 Files.isSymbolicLink(path)
Path p = Paths.get("/etc/passwd");
if (Files.exists(p) && Files.isRegularFile(p)) {
    System.out.println("是普通文件且存在");
}

Files.readAllBytes()Files.write() 适合小文件,大文件必须用流

这两个方法方便,但会把整个文件加载进内存。读一个 500MB 日志?直接 OutOfMemoryError。而且它们不处理字符

编码 —— readAllBytes() 返回 byte[]write() 也只写字节。

  • 读文本小文件(如 JSON 配置):可用 Files.readString(path, StandardCharsets.UTF_8)(Java 11+)
  • 写文本:用 Files.writeString(path, content, StandardCharsets.UTF_8)
  • 大文件或需进度控制:必须用 Files.newInputStream() / Files.newOutputStream() 配合 BufferedInputStream
// Java 11+
String json = Files.readString(Paths.get("config.json"), StandardCharsets.UTF_8);
Files.writeString(Paths.get("backup.json"), json, StandardCharsets.UTF_8);

Files.walk() 默认不递归进入不可读目录,要小心权限中断

Files.walk() 返回 Stream,看似强大,但它在遇到无权限目录时默认抛 IOException(除非用 Files.walk(path, Integer.MAX_VALUE, FileVisitOption.FOLLOW_LINKS) 并配合 tryAdvance + 异常捕获)。

  • 简单遍历且能接受中断:直接用 Files.walk(path).forEach(System.out::println)
  • 健壮遍历(跳过权限拒绝):改用 Files.walkFileTree() + 自定义 SimpleFileVisitor,重写 visitFileFailed() 返回 FileVisitResult.CONTINUE
  • 注意:Files.walk() 不关闭底层资源,Stream 要 close()(建议 try-with-resources)

真正难的不是 API 调用,而是理解 Path 是抽象路径而非字符串,Files 方法大多不“静默失败”——它们要么成功,要么明确抛异常。漏掉 try-catch IOException,或把 PathString 打印调试,是线上出问题最常见原因。