1. 概述
本文将介绍在 Java 中如何通过编程方式获取文件的扩展名。我们会重点讲解三种主流实现方式。
我们的目标很简单：提取文件名中最后一个点（.）之后的部分。
举个例子，如果文件名为 jarvis.txt，那么我们期望返回字符串 "txt" 作为其扩展名。
这看似简单，但在实际开发中容易踩坑，比如隐藏文件（.gitignore）、无扩展名文件（makefile）等边界情况。下面我们逐个分析不同方案的处理逻辑和适用场景。
2. 获取文件扩展名的方法
每种方法我们都会说明其实现原理，并重点分析以下两种特殊场景的处理结果：
- ✅ 文件名无扩展名，例如
makefile - ✅ 文件名仅包含扩展名，例如
.gitignore或.DS_Store
2.1. 原生字符串处理法
这是最简单粗暴的方式，不依赖任何第三方库，直接使用 Java 的 String 操作。
public Optional<String> getExtensionByStringHandling(String filename) {
return Optional.ofNullable(filename)
.filter(f -> f.contains("."))
.map(f -> f.substring(filename.lastIndexOf(".") + 1));
}
✅ 实现逻辑
- 先判断传入的
filename是否为null - 使用
contains(".")确保至少有一个点 - 通过
lastIndexOf(".")找到最后一个.的位置 - 截取该位置之后的子串作为扩展名
⚠️ 特殊情况处理
| 场景 | 返回值 | 说明 |
|---|---|---|
makefile（无扩展名） |
Optional.empty() |
因为不含 .，被 filter 过滤掉 |
.gitignore（只有扩展名） |
"gitignore" |
✅ 正确提取 |
💡 小贴士：返回
Optional<String>是为了更安全地处理null和无扩展名的情况，避免空指针。
❌ 缺陷
- ❌ 不处理路径分隔符问题，比如
/home/user/demo.java会被正确处理，但逻辑上不够健壮 - ❌ 如果文件名是
archive.tar.gz，会返回gz，可能不符合预期（需根据业务判断）
推荐用于轻量级场景，对性能敏感且输入可控时使用。
2.2. 使用 Apache Commons IO 的 FilenameUtils.getExtension
Apache Commons IO 是 Java 开发生态中广泛使用的工具库之一，其中 FilenameUtils 提供了跨平台的文件名解析能力。
首先添加依赖：
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-io</artifactId>
<version>2.15.1</version>
</dependency>
然后调用其提供的方法：
public String getExtensionByApacheCommonLib(String filename) {
return FilenameUtils.getExtension(filename);
}
✅ 实现原理
- 内部使用
indexOfExtension(String)方法定位扩展名起始位置 - 该方法会结合
lastIndexOf('.')和indexOfLastSeparator()判断是否在路径中误判了目录中的点 - 支持 Windows（
\）和 Unix（/）路径分隔符，具备跨平台兼容性
⚠️ 特殊情况处理
| 场景 | 返回值 | 说明 |
|---|---|---|
makefile |
""（空字符串） |
表示无扩展名 |
.gitignore |
"gitignore" |
✅ 正确提取 |
null 或空字符串 |
原样返回（即 null 或 ""） |
需调用方自行判空 |
示例：
FilenameUtils.getExtension("C:/baeldung/com/demo.java"); // 返回 "java" FilenameUtils.getExtension("/home/user/.bashrc"); // 返回 "bashrc"
✅ 优点
- ✅ 跨平台支持好
- ✅ 处理路径安全，不会把目录中的
.当作扩展名分隔符 - ✅ 社区稳定，广泛用于生产环境
❌ 缺点
- ❌ 引入整个 Commons IO 库只为一个功能，略显“杀鸡用牛刀”
- ❌ 返回
null输入时仍返回null，需额外防护
推荐项目 already 使用 Commons IO 时优先选用。
2.3. 使用 Google Guava 的 Files.getFileExtension
Guava 是 Google 出品的 Java 核心工具库，功能强大且设计优雅。
添加依赖：
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>32.1.3-jre</version>
</dependency>
使用方式非常简洁：
public String getExtensionByGuava(String filename) {
return Files.getFileExtension(filename);
}
✅ 实现逻辑
- 先判断
filename是否为空 - 构造
File对象并调用.getName()获取纯文件名（剥离路径） - 在纯文件名中查找最后一个
.的位置 - 返回其后的子串
⚠️ 特殊情况处理
| 场景 | 返回值 | 说明 |
|---|---|---|
makefile |
"" |
无扩展名，返回空串 |
.gitignore |
"gitignore" |
✅ 正确提取 |
null |
抛出 NullPointerException |
⚠️ 注意！不支持 null 输入 |
示例：
Files.getFileExtension("data.tar.xz"); // 返回 "xz" Files.getFileExtension("/tmp/.env.local"); // 返回 "local" Files.getFileExtension("no_extension"); // 返回 ""
✅ 优点
- ✅ API 极简，一行搞定
- ✅ 自动剥离路径，只基于文件名判断
- ✅ Guava 整体质量高，适合大型项目
❌ 缺点
- ❌ 不接受
null参数，传入即抛异常，调用前必须判空 - ❌ 同样为了一个小功能引入大库，需权衡
推荐已在使用 Guava 的项目中采用。
3. 总结与选型建议
三种方式各有优劣，选择应基于项目现状和技术栈：
| 方案 | 是否依赖第三方 | 安全性 | 推荐场景 |
|---|---|---|---|
| ✅ 原生字符串处理 | 否 | 中（需手动防护） | 轻量级、无依赖限制、输入可控 |
| ✅ Apache Commons IO | 是 | 高（健壮、跨平台） | 已引入 Commons IO 或注重稳定性 |
| ✅ Google Guava | 是 | 高（但 null 不友好） |
已使用 Guava 且追求简洁 API |
✅ 最佳实践建议
- 如果你追求零依赖，用 方法一，但记得封装好
null和边界判断 - 如果项目已用 Commons IO，直接上
FilenameUtils.getExtension() - 如果用了 Guava，就用
Files.getFileExtension()，但务必提前判空 - ⚠️ 不要为了一个功能单独引入大库，除非你长期需要它的其他能力
所有示例代码均可在 GitHub 查看：https://github.com/baeldung/java-tutorials/tree/master/core-java-io
合理选择工具，才能写出让同事点赞的代码 💪。