Java获取文件扩展名的5种方法

你在学习文章相关的知识吗？本文《Java获取文件扩展名的几种方法》，主要介绍的内容就涉及到，如果你想提升自己的开发能力，就不要错过这篇文章，大家要知道编程理论基础和实战操作都是不可或缺的哦！

直接使用lastIndexOf和substring不够健壮的原因有：1. 若文件名无点，lastIndexOf返回-1，调用substring会抛出异常；2. 对以点开头的隐藏文件（如.gitignore），截取结果为空，但需明确其无扩展名；3. 若传入含路径的文件名，需先提取纯文件名；4. 以点结尾的文件名（如my_document.）会返回空字符串，需判断其无扩展名。解决方案通过先提取纯文件名、判断点的位置、处理边界情况确保健壮性，或使用Apache Commons IO的FilenameUtils.getExtension()方法更便捷可靠。

在Java中获取文件扩展名，最直接的思路就是找到文件名中最后一个点（.）的位置，然后截取这个点之后的部分。但实际操作起来，会遇到一些需要考量的边界情况，比如文件本身就没有扩展名、或者像.gitignore这样的隐藏文件。所以，虽然核心逻辑简单，但要写出健壮的代码，还是得花点心思。

在Java里提取文件后缀，通常我们会结合String类的lastIndexOf()和substring()方法。

解决方案

import java.nio.file.Path;
import java.nio.file.Paths;

public class FileExtensionExtractor {

    /**
     * 提取文件路径或文件名的扩展名。
     * 这个方法会处理一些常见的边界情况，比如没有扩展名、隐藏文件等。
     *
     * @param filename 文件名或文件路径
     * @return 文件的扩展名（不包含点），如果没有扩展名则返回空字符串。
     */
    public static String getFileExtension(String filename) {
        if (filename == null || filename.isEmpty()) {
            return "";
        }

        // 先获取纯粹的文件名，去除路径部分
        Path path = Paths.get(filename);
        String pureFilename = path.getFileName().toString();

        int dotIndex = pureFilename.lastIndexOf('.');

        // 1. 如果没有点，或者点是第一个字符（例如：.bashrc），通常认为没有扩展名
        //    这里需要一个判断：如果点是第一个字符，并且是唯一的点，我们通常不把它当作扩展名。
        //    例如：".gitignore" 扩展名是空，"archive.tar.gz" 扩展名是gz。
        if (dotIndex == -1 || dotIndex == 0) {
            return "";
        }

        // 2. 如果点是最后一个字符，也认为没有扩展名（例如："my_document."）
        if (dotIndex == pureFilename.length() - 1) {
            return "";
        }

        // 3. 正常情况，截取点之后的部分
        return pureFilename.substring(dotIndex + 1);
    }

    public static void main(String[] args) {
        System.out.println("test.txt -> " + getFileExtension("test.txt"));           // txt
        System.out.println("archive.tar.gz -> " + getFileExtension("archive.tar.gz")); // gz
        System.out.println("document -> " + getFileExtension("document"));         // ""
        System.out.println(".gitignore -> " + getFileExtension(".gitignore"));     // ""
        System.out.println("MyFile. -> " + getFileExtension("MyFile."));           // ""
        System.out.println("/path/to/image.jpg -> " + getFileExtension("/path/to/image.jpg")); // jpg
        System.out.println("C:\\Users\\User\\doc.pdf -> " + getFileExtension("C:\\Users\\User\\doc.pdf")); // pdf
        System.out.println("file_without_ext -> " + getFileExtension("file_without_ext")); // ""
        System.out.println(".config.bak -> " + getFileExtension(".config.bak")); // bak
        System.out.println(" -> " + getFileExtension("")); // ""
        System.out.println("null -> " + getFileExtension(null)); // ""
    }
}

为什么直接使用lastIndexOf和substring可能不够健壮？

单纯地依赖lastIndexOf('.')和substring(dotIndex + 1)来获取扩展名，在很多场景下确实能工作，但一旦遇到一些“不按常理出牌”的文件名，比如没有扩展名、隐藏文件、或者文件名本身就是个路径，那结果可能就不是我们想要的了。

首先，如果文件名中根本没有点，lastIndexOf会返回-1，这时候直接substring就会抛出IndexOutOfBoundsException。这是最基本的错误。

其次，对于像.gitignore或者.bashrc这类以点开头的隐藏文件，如果直接取最后一个点后面的内容，那结果会是空字符串，这倒还好，但关键是，我们通常认为这类文件是没有“扩展名”的。如果你的业务逻辑需要区分“无扩展名”和“隐藏文件”，那么这种简单的判断就不够用了。

再者，如果传入的是一个完整的文件路径，例如/home/user/documents/report.pdf，lastIndexOf会在整个路径中寻找最后一个点，但我们想要的只是report.pdf的扩展名。这时候就需要先从路径中提取出纯粹的文件名。Java 7引入的NIO.2 Path API在这里就显得非常有用，Paths.get(filename).getFileName().toString()可以很方便地解决这个问题。

最后，还有一些奇怪的文件名，比如my_document.，以点结尾。按照常理，它也没有扩展名，但如果直接substring(dotIndex + 1)，会得到一个空字符串。虽然结果是空，但这个空字符串的含义可能和没有点的空字符串含义有所不同，需要明确定义。

这些细节虽然看似微不足道，但在生产环境中，任何一个边界条件考虑不周，都可能导致程序崩溃或逻辑错误。

如何处理没有扩展名或隐藏文件的情况？

处理没有扩展名和隐藏文件，关键在于对“点”的位置进行更细致的判断。

对于没有扩展名的文件，比如document，lastIndexOf('.')会返回-1。在这种情况下，我们直接返回空字符串即可。这是最直观的处理方式。

而对于隐藏文件，比如.gitignore或.bashrc，它们以点开头，且可能没有其他点。这时候，lastIndexOf('.')会返回0。我们通常认为这类文件没有传统意义上的扩展名。所以，当dotIndex为0时，也应该返回空字符串。

一个更复杂的例子是.config.bak。这个文件以点开头，但后面还有一个点。按照常规理解，它的扩展名应该是bak。这就要求我们的逻辑不能仅仅判断dotIndex == 0就直接返回，而是要确保这个点是唯一的点，并且是第一个字符。如果dotIndex == 0，但后面还有其他点，那么它依然可能有扩展名。

所以，一个比较稳健的判断逻辑是：

1. 如果dotIndex是-1，表示没有点，返回空字符串。
2. 如果dotIndex是0，表示点是第一个字符，但需要进一步判断：如果文件名长度大于1，并且在点之后没有其他非点字符，或者说整个文件名就是.，那么也返回空字符串。否则，如果后面还有内容，比如.config.bak，那就继续按正常逻辑处理。
3. 如果dotIndex是文件名长度-1，表示点是最后一个字符，返回空字符串。

通过这样的多重判断，可以比较准确地筛选出真正的扩展名。在上面的解决方案代码中，if (dotIndex == -1 || dotIndex == 0)这个条件，实际上已经涵盖了大部分常见情况，.gitignore会被正确识别为无扩展名。而像.config.bak这种，dotIndex是6，不满足dotIndex == 0，所以会正常截取到bak，符合预期。

Apache Commons IO库提供了哪些更便捷的方法？

在Java生态中，很多时候我们不需要“重复造轮子”，尤其是在文件操作这种常见且容易出错的领域。Apache Commons IO库就是这样一个宝藏，它提供了大量实用的工具类，其中org.apache.commons.io.FilenameUtils就是专门用来处理文件名和路径的。

FilenameUtils提供了getExtension(String filename)方法，它可以非常健壮地提取文件扩展名。这个方法内部已经处理了我们前面讨论过的各种边界情况，包括：

• 文件名中没有点。
• 文件名以点开头（如.bashrc）。
• 文件名以点结尾（如document.）。
• 包含路径的文件名（如/path/to/file.txt）。
• 空字符串或null输入。

使用FilenameUtils，你的代码会变得更简洁、更可靠，而且减少了自己处理各种边缘情况的复杂性。

要使用它，你需要先在你的项目中引入Apache Commons IO的依赖，如果你使用Maven，可以添加如下配置：

<dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.11.0</version> <!-- 请使用最新稳定版本 -->
</dependency>

然后，使用起来就非常简单了：

import org.apache.commons.io.FilenameUtils;

public class CommonsIOExtensionExtractor {

    public static void main(String[] args) {
        System.out.println("test.txt -> " + FilenameUtils.getExtension("test.txt"));           // txt
        System.out.println("archive.tar.gz -> " + FilenameUtils.getExtension("archive.tar.gz")); // gz
        System.out.println("document -> " + FilenameUtils.getExtension("document"));         // ""
        System.out.println(".gitignore -> " + FilenameUtils.getExtension(".gitignore"));     // ""
        System.out.println("MyFile. -> " + FilenameUtils.getExtension("MyFile."));           // ""
        System.out.println("/path/to/image.jpg -> " + FilenameUtils.getExtension("/path/to/image.jpg")); // jpg
        System.out.println("C:\\Users\\User\\doc.pdf -> " + FilenameUtils.getExtension("C:\\Users\\User\\doc.pdf")); // pdf
        System.out.println("file_without_ext -> " + FilenameUtils.getExtension("file_without_ext")); // ""
        System.out.println(".config.bak -> " + FilenameUtils.getExtension(".config.bak")); // bak
        System.out.println(" -> " + FilenameUtils.getExtension("")); // ""
        System.out.println("null -> " + FilenameUtils.getExtension(null)); // ""
    }
}

除了getExtension()，FilenameUtils还提供了getBaseName(String filename)（获取不带扩展名的文件名）、getName(String filename)（获取不带路径的文件名，包括扩展名）等方法，非常实用。在实际项目中，我个人会优先推荐使用这类成熟的第三方库，它们经过了大量测试和社区验证，能有效避免自己写代码时可能遗漏的各种细节。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。