Go 怎么按通配符查找文件并处理无匹配结果

在目录里按文件名模式筛选时，Go 的 filepath.Glob 已经够用：先用 filepath.Join 组合目录和模式，再把返回的 error 与空结果分开处理。没有文件匹配是正常分支，通配符语法写错才需要当成输入错误；如果目标是跨多层目录递归查找，则应该换用 filepath.WalkDir。

filepath.Glob 的判断顺序是“先看 error，再看 matches 是否为空”。空结果不要被误报成系统异常，ErrBadPattern 也不要被静默吞掉。

先把 Glob 当成有明确边界的筛选器

这个模式适合“在一个已知目录中找一批名字符合规则的文件”，例如找配置目录下所有 .yaml 文件，或找某个导出目录里的 report-*.csv。它的价值不在于替你遍历整棵目录树，而在于把文件名筛选交给标准库，并返回一个可以直接消费的路径集合。

package main

import (
    "fmt"
    "path/filepath"
)

func findGoFiles(dir string) ([]string, error) {
    // Join 使用当前系统的路径分隔符组合目录和文件名模式。
    pattern := filepath.Join(dir, "*.go")
    matches, err := filepath.Glob(pattern)
    if err != nil {
        // 非法的 *, ?, [] 等模式要作为调用方输入错误返回。
        return nil, fmt.Errorf("文件模式无效: %w", err)
    }
    if len(matches) == 0 {
        // 没有匹配项是正常结果，用空切片表达“本次没有文件”。
        return []string{}, nil
    }
    return matches, nil
}

这里先判断 err，再判断切片长度。调用方可以把空切片显示成“没有待处理文件”，也可以直接结束本轮任务；不要因为没有匹配就重试同一个模式。

无匹配不是异常，ErrBadPattern 才是输入问题

通配符模式没有命中任何文件时，Glob 返回的是空结果；文档中的返回描述是 nil，因此用 len(matches) == 0 判断最稳妥，既能覆盖 nil，也能覆盖其他来源构造的空切片。此时 err 应该仍为 nil。

另一条分支是模式本身不合法，例如字符类没有闭合。它返回 filepath.ErrBadPattern，这通常说明调用方拼接了错误的用户输入，或者配置文件中的模式需要修正。日志里可以记录原始模式，但不要把这类错误包装成“目录为空”，否则排查方向会被带偏。

还要注意一个容易忽略的语义：Glob 会忽略读取目录时遇到的文件系统错误，唯一可能返回的错误是非法模式。因此，如果业务必须知道目录是否存在、是否有权限读取，应该在调用 Glob 前自行检查目录，或者改用更能暴露遍历错误的方案。

模式语法只覆盖当前路径段

* 匹配一段中任意长度的非分隔符字符，? 匹配一个非分隔符字符，[] 表示字符范围。它们组合起来可以写出 part-?.go、report-[0-9].csv 这样的筛选条件，但不要把 **/*.go 理解成所有层级的递归语法：路径分隔符把目录段隔开，星号不会跨过它。

因此，目录层级已知时可以明确写出 logs/*/error-*.log；目录层级不确定时，应使用 filepath.WalkDir 在回调中按文件名、扩展名或其他条件筛选。这个选择让代码意图更清楚，也避免读者误以为 Glob 会自动发现深层目录。

反例：把 Glob 当成递归搜索器

最常见的反例是直接接收一个用户传入的 **/*.go，然后把返回为空解释为“项目里没有 Go 文件”。真正的问题可能是目录层级超过了模式能力，或者不同操作系统的分隔符写法不一致。应先确定需求是“某一层的文件名匹配”，还是“目录树中的递归筛选”。

如果只是跨平台拼接路径，不要手写 /。使用 filepath.Join；如果处理的是始终使用正斜杠的 URL，则应使用 path 包，而不是把 URL 当成本地文件路径交给 filepath。

什么时候该选哪一种写法

可以把这张表当成收尾清单：先确认路径类型，再确认目录深度，最后决定空结果是业务状态还是需要提示用户的输入错误。这样使用 Glob，代码短，但边界不会被短写法遮住。

相关问题

Go Glob 没找到文件时应该返回 error 吗？

通常不用。没有匹配项属于正常结果，返回空切片即可；只有模式格式错误等 error 才需要进入错误处理分支。

filepath.Glob 能递归查找所有子目录吗？

不应把它当作递归 API。目录层级不确定时，用 filepath.WalkDir 遍历，再在回调里筛选文件名。

为什么要用 filepath.Join 拼模式？

因为 filepath 按目标操作系统处理文件路径分隔符。目录和文件名模式分开传给 Join，比手写固定分隔符更稳妥。

把空结果当成设计的一部分

filepath.Glob 最适合做边界清晰的文件名筛选：匹配到了就处理路径集合，没匹配到就结束本轮，模式错误则提示调用方修正输入。只要不把空结果误报成异常，也不把 Glob 误当成递归遍历器，这个标准库函数就能保持简单、可预测。