Go filepath.Glob 没匹配时怎样区分错误和空结果

使用 filepath.Glob 查找文件时，matches 为空并不等于调用失败。它只会把“通配模式本身写坏”报告为 filepath.ErrBadPattern；合法模式没有匹配项，甚至查找目录时遇到部分文件系统错误，都可能得到空结果和 nil 错误。

因此判断顺序应当是：先看 err 是否为 filepath.ErrBadPattern，再看 len(matches) 是否为 0。如果业务还要知道“目录不存在”或“权限不足”，就不能只依赖 Glob，还要用 os.Stat、os.ReadDir 等 API 补查。

官方资料：https://pkg.go.dev/path/filepath#Glob

先把 Glob 的返回契约记清楚

filepath.Glob(pattern) 返回两个值：匹配路径集合和错误。官方契约有两个容易被忽略的边界：

• 没有匹配文件时，匹配集合为 nil，错误仍然可以是 nil。
• 唯一可能返回的错误是 filepath.ErrBadPattern，它表示模式语法不合法。

这里的“唯一可能返回错误”不代表所有文件系统问题都会被上报。Glob 会忽略读取目录时的 I/O 错误，所以它更适合做“尽力查找”，而不是做完整的目录诊断。

模式写错时，错误就是 ErrBadPattern

最典型的错误是字符类没有闭合，例如 logs/[0-9.txt。此时不要把空匹配当作普通“没有文件”，而要保留错误信息，让调用方修正模式或记录输入来源。

package main

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

func inspectPattern(pattern string) {
    matches, err := filepath.Glob(pattern)
    if err != nil {
        // Glob 的模式错误可用 ErrBadPattern 精确分类，避免把它当成空结果。
        if errors.Is(err, filepath.ErrBadPattern) {
            fmt.Printf("模式无效: %q: %v\\n", pattern, err)
            return
        }
        // 保留未来实现或包装错误的上下文，不能静默吞掉未知错误。
        fmt.Printf("查找失败: %q: %v\\n", pattern, err)
        return
    }

    if len(matches) == 0 {
        // 合法模式没有命中项，这是正常的空结果状态。
        fmt.Printf("没有匹配项: %q\\n", pattern)
        return
    }

    // Glob 返回的路径已经按字典序组织，可直接交给后续业务处理。
    fmt.Printf("找到 %d 个路径: %v\\n", len(matches), matches)
}

虽然当前实现直接返回 ErrBadPattern，这里使用 errors.Is 仍然更适合长期维护：如果上层以后给错误增加上下文包装，分类逻辑不会因为错误文本变化而失效。

合法模式没有匹配项时，不要误报异常

例如 reports/*.csv 语法完全正确，但目录里没有 CSV 文件，返回值可能是 nil, nil。代码应该把它表达成业务上的“暂无文件”，而不是“扫描失败”。

func findReports(pattern string) ([]string, error) {
    matches, err := filepath.Glob(pattern)
    if err != nil {
        // 模式错误属于调用方输入问题，向上层返回可识别的原始错误。
        return nil, fmt.Errorf("解析文件模式 %q: %w", pattern, err)
    }
    if len(matches) == 0 {
        // 空集合是可预期状态，由业务决定是等待、跳过还是提示用户。
        return []string{}, nil
    }
    return matches, nil
}

这里用 len(matches) 而不是只判断 matches == nil。对调用方而言，nil 和长度为 0 都代表没有元素；统一按长度判断，能避免后续包装函数把空集合改成非 nil 切片后产生分支差异。

想知道目录不存在或权限问题，要主动补查

Glob 的设计目标是找出能匹配的路径，它会忽略目录读取阶段的 I/O 错误。因此下面几种情况都可能落到“空结果”：目录不存在、目录不可读、通配符前面的目录层级无法打开，以及目录确实存在但没有命中项。

如果业务必须区分这些原因，可以先拆出固定目录，再用 os.Stat 检查它：

func globWithDirectoryReason(pattern, dir string) ([]string, error) {
    info, err := os.Stat(dir)
    if err != nil {
        // 先检查固定目录，能够区分不存在、权限失败等基础原因。
        return nil, fmt.Errorf("检查目录 %q: %w", dir, err)
    }
    if !info.IsDir() {
        // 通配模式依赖目录层级时，普通文件不能替代目录。
        return nil, fmt.Errorf("路径不是目录: %s", dir)
    }

    matches, err := filepath.Glob(pattern)
    if err != nil {
        // 保留 Glob 的模式分类，让调用方能单独处理输入错误。
        return nil, fmt.Errorf("执行模式 %q: %w", pattern, err)
    }
    return matches, nil
}

若要进一步诊断目录读取权限，可以使用 os.ReadDir(dir)，因为它会把读取目录的错误直接返回。不要为了得到更多错误而反复调用 Glob，那不会改变它“忽略文件系统错误”的契约。

把三种状态收敛成调用方看得懂的结果

实际项目中可以把判断集中在一个小函数里：模式错误走错误分支；合法但无匹配返回明确的空集合；命中时返回排序后的路径。这样上层不用猜测 nil 是异常还是没有文件。

type MatchState int

const (
    MatchFound MatchState = iota
    MatchEmpty
)

func collect(pattern string) ([]string, MatchState, error) {
    matches, err := filepath.Glob(pattern)
    if err != nil {
        // 把语法错误保留在 error 中，状态值只描述成功后的集合状态。
        return nil, MatchEmpty, fmt.Errorf("glob %q: %w", pattern, err)
    }
    if len(matches) == 0 {
        // 空集合是成功调用后的业务状态，不与 error 混用。
        return []string{}, MatchEmpty, nil
    }
    return matches, MatchFound, nil
}

如果业务还需要区分“目录不存在”和“目录存在但为空”，应把目录检查作为单独的前置步骤或返回类型，而不是把更多语义硬塞进 Glob。

最后用一张表避免判断混乱

相关问题

• 为什么不能用 err != nil 判断 Glob 是否找到文件？ 因为合法模式的空结果本来就是 nil 错误。
• filepath.Glob 会报告目录权限错误吗？ 不保证；它会忽略目录读取阶段的文件系统错误。
• 什么时候该用 filepath.Match？ 只想判断一个已有文件名是否符合模式时，可以直接使用 Match，不必访问目录。
• 为什么要用 errors.Is？ 它能识别被上下文包装的 ErrBadPattern，比比较错误字符串稳定。

记住一句话：Glob 的错误主要说明模式坏了，空结果主要说明没有找到可返回的路径；想解释文件系统为什么没有结果，就再做一次显式目录检查。