Go filepath.Glob 返回空结果时怎样判断模式无效

结论：filepath.Glob 返回空结果时，不能只看 matches。如果 err == nil，通常表示模式语法有效但没有找到匹配项；只有 err 为 filepath.ErrBadPattern 时，才是通配符模式本身无效。

官方文档：https://pkg.go.dev/path/filepath#Glob

这一区分很重要，因为 Glob 还会忽略读取目录时遇到的文件系统 I/O 错误。把“空切片”直接当成“目录里没有文件”，可能会把权限或目录状态问题隐藏掉。

为什么空结果不等于模式无效

Glob 的返回值是 (matches []string, err error)。匹配不到文件时，matches 可以是 nil，err 仍然是 nil；模式写错时，err 才会指向 filepath.ErrBadPattern。所以排查顺序应当是先判断错误，再判断匹配数量。

package main

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

func main() {
    patterns := []string{"reports/*.csv", "reports/[.csv"}
    for _, pattern := range patterns {
        matches, err := filepath.Glob(pattern)
        if err != nil {
            // Glob 唯一可能返回的错误是模式语法错误。
            if errors.Is(err, filepath.ErrBadPattern) {
                fmt.Printf("模式无效: %s\\n", pattern)
                continue
            }
            // 保留未知错误分支，避免以后更换实现时静默吞错。
            fmt.Printf("匹配失败: %v\\n", err)
            continue
        }
        if len(matches) == 0 {
            // 空结果表示当前可见目录中没有匹配项，不等于模式错误。
            fmt.Printf("没有匹配项: %s\\n", pattern)
            continue
        }
        fmt.Printf("找到 %d 个文件\\n", len(matches))
    }
}

用 filepath.Match 预检查通配符

如果业务允许用户输入模式，可以先调用 filepath.Match 做语法检查。它只比较模式与一个示例名称，不负责查目录；返回的错误同样可以用 errors.Is 判断。这样可以把“输入格式不对”尽早反馈给调用方。

func validatePattern(pattern string) error {
    // 示例名称只用于触发模式解析，不代表真实文件存在。
    _, err := filepath.Match(pattern, "placeholder.txt")
    if err != nil {
        // 将标准库的模式错误原样返回，便于上层记录和提示。
        return fmt.Errorf("invalid glob pattern: %w", err)
    }
    return nil
}

func findReports(pattern string) ([]string, error) {
    if err := validatePattern(pattern); err != nil {
        // 先挡住非法输入，再访问文件系统。
        return nil, err
    }
    matches, err := filepath.Glob(pattern)
    if err != nil {
        // 保留 Glob 的错误返回，不把错误伪装成空结果。
        return nil, err
    }
    return matches, nil
}

注意，合法模式也可能没有任何匹配项。例如 reports/*.csv 在目录为空时仍是有效模式；预检查只能回答“语法是否成立”，不能替代实际目录查询。

路径拼接要跟着目标系统走

Glob 的通配符规则与目标系统的路径分隔符相关，* 和 ? 默认不会跨越分隔符；代码中也可以用 filepath.Separator 表示当前系统的分隔符。不要把 URL 的斜杠规则直接套到本地文件路径上，目录和模式可以先用 filepath.Join 组合。

func reportPattern(root string) string {
    // Join 使用当前系统的路径分隔符，适合本地文件路径。
    return filepath.Join(root, "reports", "*.csv")
}

func matchOne(pattern, name string) (bool, error) {
    // Match 要求整个 name 都匹配，而不是只匹配其中一段。
    matched, err := filepath.Match(pattern, name)
    if err != nil {
        // 让调用方区分模式错误与普通的不匹配。
        return false, fmt.Errorf("check name: %w", err)
    }
    return matched, nil
}

在 Windows 上，反斜杠是路径分隔符，不能照搬 Unix 下用反斜杠转义通配符的写法。跨平台配置最好保存逻辑片段，再在运行时用 filepath.Join 组合。

别把 Glob 的空结果当成完整的文件系统诊断

官方文档明确说明，Glob 会忽略读取目录时出现的 I/O 错误。因此权限不足、目录短暂不可读等情况，可能与“没有匹配项”表现得相似。如果业务必须区分这些状态，应先确认目录可访问，或改用 os.ReadDir、filepath.WalkDir 等能让错误显式返回的方案，再自行应用 filepath.Match。

可以把排障结果统一成三类：模式错误记录 ErrBadPattern；合法但无匹配记录模式和目标目录；需要诊断目录状态改用可返回 I/O 错误的遍历 API。这样日志和上层提示就不会把不同原因混在一起。

常见问题

为什么 matches 是 nil 还要看 err？

因为 nil 只说明当前没有可返回的匹配路径，不能单独说明模式有效、目录可读或目标文件一定不存在。先看 err，再看 len(matches)，才不会把模式错误当成空目录。

Glob 能报告目录权限错误吗？

不能把它当作完整的权限诊断工具。Glob 会忽略目录读取 I/O 错误；对权限、目录消失和遍历失败敏感的场景，应改用显式遍历并处理返回的错误。