在Java项目里，处理文件上传、日志归档、资源加载等功能时，几乎都会遇到从完整路径中提取文件名的需求。直接用字符串截取虽然能实现，但面对Windows和Linux路径分隔符差异时极易出错。Java NIO提供的Path.getFileName方法正是为此而生，它能准确返回路径中的最后一个元素，即文件名部分。本文将系统讲解这个方法的使用方式，以及围绕文件名展开的后缀判断与处理逻辑。
一、Path.getFileName方法的基本用法与原理
Path是Java 7引入的NIO.2中的核心接口，通过Paths.get()可以创建实例。getFileName()方法返回路径的最后一个名称元素，返回值依然是一个Path对象，需要调用toString()转成字符串。
import java.nio.file.Path;
import java.nio.file.Paths;
public class GetFileNameDemo {
public static void main(String[] args) {
// Windows风格路径
Path winPath = Paths.get("C:\\Users\\admin\\report.pdf");
System.out.println(winPath.getFileName()); // 输出: report.pdf
// Linux风格路径
Path linuxPath = Paths.get("/var/log/app/error.log");
System.out.println(linuxPath.getFileName()); // 输出: error.log
// 相对路径同样适用
Path relPath = Paths.get("data/2024/sales.csv");
System.out.println(relPath.getFileName()); // 输出: sales.csv
}
}这个方法的好处在于它不关心分隔符到底是\还是/，内部会根据当前文件系统自动解析。如果换成手动字符串截取，就得同时判断两种分隔符，代码会变得又长又难维护。
需要注意几个边界情况：如果路径本身只有一个元素（比如Paths.get("a.txt")），getFileName()返回它自身；如果路径是根路径（如C:\或/），则返回null。所以在拿到结果后，最好先做空值校验再继续后续逻辑，否则很容易抛出NullPointerException。
二、文件后缀的判断与提取逻辑
拿到文件名之后，最常见的下一步就是判断后缀。这里推荐用lastIndexOf配合判断来提取，而不是简单用endsWith，因为后者遇到大小写不一致就会失效，比如.JPG和.jpg会被当成两种不同格式。
public class SuffixUtil {
/**
* 提取小写后缀，不含点号；无后缀返回空字符串
*/
public static String getSuffix(String fileName) {
if (fileName == null) return "";
int dotIndex = fileName.lastIndexOf('.');
// 目录名如 "backup.v2" 或以点开头的隐藏文件 ".gitignore" 需要甄别
if (dotIndex == -1 || dotIndex == fileName.length() - 1 || dotIndex == 0) {
return "";
}
return fileName.substring(dotIndex + 1).toLowerCase();
}
public static void main(String[] args) {
System.out.println(getSuffix("photo.JPG")); // jpg
System.out.println(getSuffix("archive.tar.gz")); // gz
System.out.println(getSuffix("README")); // 空字符串
System.out.println(getSuffix(".gitignore")); // 空字符串，视为无后缀
}
}这段代码处理了三类容易踩坑的情况：一是大小写归一化，统一转小写后再比较；二是多重后缀如archive.tar.gz，用lastIndexOf取到最后一个点，拿到的是gz；三是没有后缀或以点开头的隐藏文件，返回空字符串而不是报错。
如果想判断是否属于允许上传的类型，建议用集合做白名单校验：
import java.util.Arrays;
import java.util.HashSet;
import java.util.Set;
Set<String> allowed = new HashSet<>(Arrays.asList("jpg", "png", "pdf", "docx"));
public boolean isAllowed(String fileName) {
return allowed.contains(SuffixUtil.getSuffix(fileName));
}白名单机制比黑名单安全得多。黑名单只拦截exe、bat等已知危险后缀，攻击者可以用双后缀（如shell.php.jpg）或大小写变体绕过；而白名单只放行明确允许的格式，默认拒绝一切其他类型，安全性明显更高。
三、后缀替换与批量重命名的实战场景
文件归档场景中经常需要修改后缀，例如把临时文件data.tmp转为正式的data.csv。这时要分两步走：先从原始路径提取文件名，再去掉旧后缀、拼上新后缀，最后用resolve拼回完整路径。
import java.nio.file.*;
public class RenameUtil {
public static Path replaceSuffix(Path original, String newSuffix) {
String name = original.getFileName().toString();
int dotIndex = name.lastIndexOf('.');
String baseName = (dotIndex == -1) ? name : name.substring(0, dotIndex);
String newName = baseName + "." + newSuffix;
return original.getParent().resolve(newName);
}
public static void main(String[] args) {
Path src = Paths.get("D:\\upload\\data.tmp");
Path dest = replaceSuffix(src, "csv");
System.out.println(dest); // 输出: D:\upload\data.csv
try {
Files.move(src, dest, StandardCopyOption.REPLACE_EXISTING);
} catch (Exception e) {
e.printStackTrace();
}
}
}这里有个细节值得注意：getParent()获取父目录后用resolve()拼接新文件名，比手动字符串拼接substring(0, path.lastIndexOf("\\"))要可靠得多，因为它不依赖具体分隔符，跨平台运行也不会出问题。
如果项目里已经引入了Apache Commons IO，也可以直接使用FilenameUtils工具类，它提供了getName、getExtension、getBaseName、removeExtension等方法，内部已经处理了各种边界情况。它的优势是经过大量项目验证、行为稳定，缺点是多一层依赖。对于只有简单需求的项目，自己封装一个工具类即可；对于路径操作频繁的项目，引入工具库能省不少测试成本。
最后总结一下实践建议：所有从外部输入获取的路径，先转成Path对象再操作；getFileName()的结果使用前做空值检查；后缀判断一律转小写并采用白名单；拼接路径永远用resolve而不是加号。养成这些习惯后，路径相关代码的稳定性会有明显提升。
Path.getFileName文件路径处理文件后缀判断修改时间：2026-09-09 02:22:34