文件操作几乎是每个 Java 项目都绕不开的部分，而路径处理又是其中最容易出错的一环。有时候我们手里握着一个完整的路径，比如一份上传文件在服务器上的存储位置，但业务逻辑真正需要的只是那个文件的名字，比如用它去查数据库记录、生成日志前缀，或者拼一个新的保存路径。Java 7 引入的 NIO.2 里，Path 接口提供了一个非常直接的方法来完成这件事，就是 getFileName()。这篇文章会把这个方法的用法、边界情况以及常见的组合技巧讲清楚。
getFileName() 的基本用法与返回值特点
先看最简单的例子。假设我们有一个路径 Paths.get("D:\\docs\\project\\report.docx")，调用 getFileName() 之后得到的就是 report.docx 这一部分。需要注意的是，这个方法返回的并不是一个 String，而是一个新的 Path 对象，只是这个对象里只包含文件名这一项。如果你确实需要字符串形式，再调用一次 toString() 即可。
import java.nio.file.Path;
import java.nio.file.Paths;
public class GetFileNameDemo {
public static void main(String[] args) {
Path path = Paths.get("D:\\docs\\project\\report.docx");
Path fileName = path.getFileName();
System.out.println("文件名 Path 对象: " + fileName);
System.out.println("文件名字符串: " + fileName.toString());
}
}有两点值得特别留意。第一，如果 Path 对象本身只包含一个文件名，比如 Paths.get("notes.txt")，那么 getFileName() 返回的是与原对象等价的路径，结果不变。第二，如果路径是根路径，比如 Windows 下的 C:\ 或者 Unix 下的 /，调用该方法会返回 null，因为根路径没有更上层的文件名可言。这一点在写通用工具类时务必做好判空，否则很容易在处理磁盘根目录时抛出空指针异常。
跨平台路径差异与组合方法的配合
Path 的底层实现与操作系统相关。在 Windows 上，分隔符是反斜杠 \，而在 Linux 和 macOS 上是正斜杠 /。使用 Paths.get() 构造路径时，字符串会被按照当前系统的规则解析，所以 getFileName() 的行为天然是平台自适应的。不过如果你拿到的是来自其他系统的路径字符串，直接构造 Path 可能解析不对，这时可以先做归一化处理，或者借助 FileSystems.getDefault().getPath() 的灵活性来构造。
实际开发中，getFileName() 很少单独使用，更多时候是和一组兄弟方法配合完成路径拆解。getParent() 返回父目录，getRoot() 返回根组件，getNameCount() 和 getName(int index) 则可以逐级遍历路径中的每一个元素。另外 normalize() 能消除路径里的 . 和 ..，toAbsolutePath() 能把相对路径补全成绝对路径，这两个方法用在 getFileName() 之前，可以让结果更可靠。
import java.nio.file.Path;
import java.nio.file.Paths;
public class PathSplitDemo {
public static void main(String[] args) {
Path path = Paths.get("/var/log/app/../service/run.log").normalize();
System.out.println("归一化后: " + path);
System.out.println("文件名: " + path.getFileName());
System.out.println("父目录: " + path.getParent());
System.out.println("根路径: " + path.getRoot());
// 逐级打印路径元素
for (int i = 0; i < path.getNameCount(); i++) {
System.out.println("第 " + i + " 级: " + path.getName(i));
}
}
}上面这段代码展示了完整的路径解剖流程。先 normalize() 去掉冗余的 ..，再分别取出文件名、父目录和根路径。这种组合在处理用户上传文件、拼接输出目录时非常常见，比手动用 lastIndexOf(File.separator) 去截取字符串要健壮得多，因为后者在遇到路径末尾带分隔符、路径为空等情况时很容易出 bug。
实战场景：批量重命名与日志记录中的应用
来看一个更贴近真实业务的例子：遍历某个目录下的所有文件，提取文件名，按规则重命名并记录日志。这个场景综合用到了 Files.list()、getFileName() 以及字符串处理。注意 Files.list() 返回的流需要显式关闭，否则在 Windows 上可能长期占用目录句柄，导致目录无法删除。
import java.io.IOException;
import java.nio.file.*;
public class BatchRename {
public static void main(String[] args) throws IOException {
Path dir = Paths.get("D:\\uploads");
try (var files = Files.list(dir)) {
files.filter(Files::isRegularFile)
.forEach(source -> {
String name = source.getFileName().toString();
// 提取主名和扩展名
int dot = name.lastIndexOf('.');
String base = dot > 0 ? name.substring(0, dot) : name;
String ext = dot > 0 ? name.substring(dot) : "";
Path target = source.resolveSibling(base + "_backup" + ext);
try {
Files.move(source, target, StandardCopyOption.REPLACE_EXISTING);
System.out.println("已重命名: " + name + " -> " + target.getFileName());
} catch (IOException e) {
System.err.println("处理失败: " + name + ", 原因: " + e.getMessage());
}
});
}
}
}这段代码里有几个细节。一是 resolveSibling()，它在同一个父目录下生成新路径，避免手工拼接；二是扩展名的判断用了 dot > 0 而不是 dot != -1，这样能正确处理类似 .gitignore 这种以点开头的隐藏文件，把整个名字视为主名。三是每个文件的重命名都包裹了独立的异常处理，单个文件失败不会中断整批任务，这在生产环境中很重要。
除了重命名，getFileName() 在日志和审计场景中也高频出现。比如记录某个配置文件最后被谁修改过，日志里通常只写文件名而不写全路径，一来省空间，二来避免泄露服务器目录结构。写法上把它和 toAbsolutePath() 区分开：toAbsolutePath() 是把相对路径补全，getFileName() 是做减法取最后一级，两者方向相反，不要混淆。
总结一下，Path.getFileName() 是一个看似简单但边界情况不少的方法。记住三个要点：返回值是 Path 而非字符串、根路径调用会返回 null、处理前先 normalize() 更稳妥。掌握了这些，再加上与 getParent()、resolveSibling() 等方法的组合，绝大多数文件名提取需求都能优雅地解决。
Path.getFileName()Java文件路径Path API修改时间：2026-09-13 05:04:40