Go 怎么判断文件扩展名：隐藏文件和多重后缀怎么处理

Go 里判断文件扩展名，通常从 filepath.Ext 开始。它只查看路径最后一个元素，从最后一个点开始返回后缀，并且保留点号：report.txt 得到 .txt，archive.tar.gz 得到 .gz，没有点则得到空字符串。隐藏文件和多重后缀不是 API 出错，而是业务规则需要先说清楚。

Go标准库的path.Ext只能拿到最后一个点之后的后缀，处理隐藏文件需要提前判断文件名首个字符是不是点，多重后缀可以自己从后往前截取匹配预设后缀长度的字符串，就能覆盖绝大多数业务场景。

用 filepath.Ext 判断普通文件的最后一个扩展名

官方文档对 filepath.Ext 的定义很明确：扩展名是路径最后一个元素中，从最后一个点开始的后缀；路径里没有点时返回空字符串。因此不要把它当成“识别文件格式”的完整方案，它只负责做词法切分。

package main

import (
    "fmt"
    "path/filepath"
)

func main() {
    samples := []string{"report.txt", "archive.tar.gz", "README"}
    for _, name := range samples {
        // Ext 的返回值包含点号；空字符串表示没有可取的后缀。
        fmt.Printf("%q -> %q\n", name, filepath.Ext(name))
    }
}

这个例子会得到 ".txt"、".gz" 和 ""。比较时可以直接写 strings.EqualFold(filepath.Ext(name), ".jpg")，但如果扩展名将作为安全白名单，建议先明确是否允许大小写变体，而不是无条件放宽。

先取最后路径元素，再处理隐藏文件

判断扩展名时不用先手写字符串切分。filepath.Ext("dir.v1/readme") 返回空字符串，因为目录名的点不在最终文件名里；而 filepath.Ext("config/.env") 返回 .env。这正是隐藏文件的常见坑：从库函数角度它有后缀，从很多 Unix 工具的命名习惯看它又可能只是一个隐藏文件名。

如果产品规则是“只有点号后面还有正文时才算扩展名”，可以先取基础名，再排除以点开头且中间没有其他点的名字。不要把这个判断偷偷塞进所有调用方，否则上传、检索和清理任务会对同一文件得出不同结论。

多重后缀不要把 .tar.gz 当成一个自动结论

archive.tar.gz 返回 .gz 并不意味着 Go 不支持多重后缀，而是 Ext 的职责就是最后一个扩展名。如果业务要识别 gzip 压缩包，可以比较最后后缀；如果要识别“tar 归档再 gzip 压缩”的完整命名，则应比较文件名结尾。

package main

import (
    "fmt"
    "path/filepath"
    "strings"
)

func isTarGz(name string) bool {
    // 统一大小写后只判断命名约定，不把文件内容误当成已验证格式。
    lower := strings.ToLower(filepath.Base(name))
    return strings.HasSuffix(lower, ".tar.gz")
}

func main() {
    fmt.Println(isTarGz("backup/DB.TAR.GZ")) // true
}

需要更严格的文件类型判断时，应读取文件头或使用业务协议提供的 MIME 信息；文件名后缀只能说明命名，不等于内容一定匹配。反过来，如果只是给下载文件分类，文件名规则通常更直接，也更容易解释。

把扩展名判断收敛成可复用函数

实际项目里可以把规则固定在一个函数中：先取基础名、统一大小写，再按白名单返回结果。下面的函数把隐藏文件视为“无扩展名”，同时保留对复合后缀的显式支持。

func acceptedExtension(name string) (string, bool) {
    base := strings.ToLower(filepath.Base(name))
    // 单独的 .env、.gitignore 不进入普通扩展名白名单。
    if strings.HasPrefix(base, ".") && !strings.Contains(strings.TrimPrefix(base, "."), ".") {
        return "", false
    }
    switch {
    case strings.HasSuffix(base, ".tar.gz"):
        return ".tar.gz", true
    case strings.HasSuffix(base, ".jpg"), strings.HasSuffix(base, ".png"):
        return filepath.Ext(base), true
    default:
        return "", false
    }
}

函数里的规则要配 table-driven 测试，至少覆盖普通文件、隐藏文件、目录名带点、多重后缀、无后缀和大写后缀。这样后续增加 .webp 或改变隐藏文件策略时，修改点和影响范围都很清楚。

常见问题

filepath.Ext 返回的扩展名为什么带点？

因为它返回的是从最后一个点开始的后缀，例如 .json。比较时统一带点即可，也可以先用 strings.TrimPrefix 转成不带点的形式，但不要两种约定混用。

Go 怎么判断文件是 tar.gz？

按文件名判断时，用 strings.HasSuffix(strings.ToLower(filepath.Base(name)), ".tar.gz")；这只是命名判断，不能替代读取文件内容或校验压缩格式。

.env 应该算扩展名吗？

filepath.Ext 会返回 .env，但很多业务把它当隐藏文件名。上传过滤、配置扫描和文件展示应选定同一规则并写进测试。