Java 取得檔案副檔名三種做法：正則、substring、Files API

前言

取得檔案副檔名是檔案處理的基礎操作。本文整理三種主流做法：正則表達式、字串截取、現代 NIO API，並比較其優缺點與適用場景，附上完整可執行程式碼。

方法一：正則表達式

適合需驗證副檔名格式、支援多種命名規則的情境：

import java.util.regex.*;

public class RegexExtension {
    public static String getExtension(String fileName) {
        // 匹配最後一個點之後的英文字母
        String regex = ".+\\.([a-zA-Z]+)$";
        Pattern pattern = Pattern.compile(regex);
        Matcher matcher = pattern.matcher(fileName);
        if (matcher.find()) {
            return matcher.group(1).toLowerCase();
        }
        return "";
    }

    public static void main(String[] args) {
        System.out.println(getExtension("image.jpg"));        // jpg
        System.out.println(getExtension("archive.tar.gz"));   // gz
        System.out.println(getExtension("README"));           // 空字串
        System.out.println(getExtension(".hidden"));          // 空字串
    }
}

方法二：字串截取 - 最常用、效能最佳

利用 lastIndexOf('.') 定位最後一個點號位置：

public class SubstringExtension {
    public static String getExtension(String fileName) {
        if (fileName == null) return "";
        int dotIndex = fileName.lastIndexOf('.');
        // 條件：有點號、點號不在第一位、點號不在最後
        if (dotIndex > 0 && dotIndex < fileName.length() - 1) {
            return fileName.substring(dotIndex + 1).toLowerCase();
        }
        return "";
    }

    // 替代寫法：指定結束位置
    public static String getExtensionV2(String fileName) {
        int dotIndex = fileName.lastIndexOf('.');
        if (dotIndex > 0) {
            return fileName.substring(dotIndex + 1, fileName.length()).toLowerCase();
        }
        return "";
    }
}

方法三：Java 7+ NIO.2 Files API - 現代標準做法

使用 Path 物件處理路徑，語意清晰且跨平台：

import java.nio.file.*;

public class NioExtension {
    public static String getExtension(String fileName) {
        Path path = Paths.get(fileName);
        String name = path.getFileName().toString(); // 僅取檔名部分
        int dotIndex = name.lastIndexOf('.');
        if (dotIndex > 0 && dotIndex < name.length() - 1) {
            return name.substring(dotIndex + 1).toLowerCase();
        }
        return "";
    }

    // 實務上常搭配 Files.probeContentType 偵測 MIME 類型
    public static void detectType(Path file) throws IOException {
        String mime = Files.probeContentType(file);
        System.out.println("MIME 類型：" + mime);
    }
}

三種做法比較表

邊界情況測試

public class EdgeCases {
    public static void main(String[] args) {
        String[] tests = {
            "normal.txt",
            "archive.tar.gz",
            ".gitignore",
            "README",
            "config.",
            ".hidden.conf",
            "path/to/file.java",
            null
        };

        for (String f : tests) {
            System.out.printf("%-20s -> '%s'%n", f, getExt(f));
        }
    }

    static String getExt(String f) {
        if (f == null) return "null輸入";
        int i = f.lastIndexOf('.');
        return (i > 0 && i < f.length() - 1) ? f.substring(i + 1) : "(無副檔名)";
    }
}

輸出結果

normal.txt           -> 'txt'
archive.tar.gz       -> 'gz'
.gitignore           -> '(無副檔名)'
README               -> '(無副檔名)'
config.              -> '(無副檔名)'
.hidden.conf         -> 'conf'
path/to/file.java    -> 'java'
null輸入             -> 'null輸入'

實務建議

1. 一般專案：直接使用 substring + lastIndexOf，效能最好、程式碼最簡潔
2. Spring Boot / 現代專案：善用 Path 物件，配合 FilenameUtils.getExtension() (Apache Commons IO) 更穩健
3. 需驗證副檔名白名單：搭配正則或 Set<String> allowed = Set.of("jpg","png","pdf") 驗證
4. 注意：副檔名不代表檔案真實類型，安全敏感場景必須檢查 Magic Number / MIME Type

線上工具推薦

• 正則測試：JavaScript 正則線上測試
• 正則生成：正則表達式線上生成