Go filepath.Glob 遇到坏模式时为什么只返回 ErrBadPattern

文件批处理里，filepath.Glob 返回空切片时，最容易被误判成“目录读取失败”或“程序没有找到文件”。真正需要先分开的，是三种结果：匹配成功、模式合法但没有匹配项，以及模式本身写坏了。Go 官方实现把第三种情况报告为 filepath.ErrBadPattern；无匹配通常是 nil 结果和 nil 错误，目录读取等文件系统错误则不会作为 Glob 的错误返回。

官方地址：https://pkg.go.dev/path/filepath#Glob

看到 ErrBadPattern 时，先修正模式语法；看到 matches == nil 且 err == nil 时，只能说明当前模式没有匹配结果，不能把它当成模式错误。

先把“没有文件”拆成三种现场

假设一个导入任务接收用户输入的模式：reports/*.csv。如果目录里没有 CSV，程序应该可以记录“本次没有待处理文件”并正常结束；如果输入是 reports/[2026.csv，问题在模式语法，继续往下走只会让提示变得含糊；如果目录权限或磁盘状态有问题，Glob 的契约又不会把这类 I/O 错误交给调用方。

所以排查顺序应当是：先看 err 是否为 ErrBadPattern，再看匹配数量，最后对每个结果做打开、读取等真正的业务检查。不要用“匹配为空”代替“模式解析失败”。

用一个未闭合字符类复现 ErrBadPattern

Glob 使用与 filepath.Match 相同的模式语法。字符类左括号没有对应的闭合括号，就是一个稳定的坏模式示例。下面的代码同时演示一个合法但无匹配的模式，方便把两个结果并排观察。

package main

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

func report(pattern string) {
	matches, err := filepath.Glob(pattern)
	if err != nil {
		// 只有模式语法错误才进入 ErrBadPattern 分支。
		if errors.Is(err, filepath.ErrBadPattern) {
			fmt.Printf("坏模式 %q：请修正通配符语法\n", pattern)
			return
		}
		// 保留其他错误分支，避免把未知问题当成空结果。
		fmt.Printf("模式 %q 返回了其他错误：%v\n", pattern, err)
		return
	}

	if len(matches) == 0 {
		// 合法模式没有命中时，这是正常的空结果，不是语法错误。
		fmt.Printf("模式 %q 没有匹配文件\n", pattern)
		return
	}
	fmt.Printf("模式 %q 命中 %d 个文件：%v\n", pattern, len(matches), matches)
}

func main() {
	// 用当前目录下不太可能存在的后缀模拟合法但无匹配。
	report("*.definitely-not-found")
	// 左括号未闭合，触发 filepath.ErrBadPattern。
	report("[2026.csv")
}

这里判断的是错误的语义，而不是错误字符串。使用 errors.Is 可以让判断表达“是否属于这个错误”这一意图；无匹配则通过 len(matches) == 0 处理，不应为了让调用方统一而人为包装成 ErrBadPattern。

把模式检查放在批处理入口

如果模式来自配置文件、命令行或接口参数，最合适的处理位置是任务入口，而不是遍历每一个匹配结果之后。入口先拒绝坏模式，后续逻辑就只面对“有文件”和“没有文件”两种业务状态。

func collect(pattern string) ([]string, error) {
	matches, err := filepath.Glob(pattern)
	if err != nil {
		// 给配置层返回稳定的错误上下文，不把用户输入拼进命令。
		if errors.Is(err, filepath.ErrBadPattern) {
			return nil, fmt.Errorf("文件匹配模式无效 %q: %w", pattern, err)
		}
		return nil, fmt.Errorf("文件匹配失败 %q: %w", pattern, err)
	}
	// nil 切片可以安全地被 range；调用方可把它视为“本次没有文件”。
	return matches, nil
}

func run(pattern string) error {
	files, err := collect(pattern)
	if err != nil {
		// 坏模式属于输入错误，应在任务开始时直接终止。
		return err
	}
	if len(files) == 0 {
		// 空结果是可解释的业务状态，可以记录后正常结束。
		fmt.Println("没有待处理文件")
		return nil
	}
	for _, name := range files {
		// Glob 只负责找名字；打开、权限和内容校验仍由业务层负责。
		fmt.Println("准备处理", name)
	}
	return nil
}

这段分层有一个重要好处：模式语法错误会带着原始错误链返回，调用方既能记录用户输入，也能用 errors.Is 做机器判断；而成功返回的文件名仍然需要后续 os.Open 或其他业务操作来确认可用。

为什么 Glob 不报告目录读取错误

官方文档明确说明，Glob 会忽略读取目录时出现的文件系统错误，唯一可能返回的错误是 ErrBadPattern。这意味着不能把 err == nil 理解成“每个目录都已经成功读取”，也不能把空结果当成权限问题的证据。

如果业务必须知道哪些目录无法读取，就不要只依赖 Glob 的返回值。可以先用更可观测的目录遍历方案收集错误，再使用 filepath.Match 判断每个文件名是否匹配；这会增加代码量，但能把“模式解析”和“文件系统访问”拆开记录。

我会保留的复查清单

• 模式错误用 errors.Is(err, filepath.ErrBadPattern) 判断，不比较固定错误文本。
• matches 为空且 err 为 nil 时，表示没有匹配项，不表示模式坏了。
• Glob 不报告目录读取等文件系统错误；对可观测性有要求时要设计额外的遍历或访问检查。
• 文件名匹配成功不等于文件可打开，权限、删除竞态和内容格式仍要在业务层处理。
• 来自外部的模式应记录输入上下文，但不要为了执行匹配而把它拼进 shell 命令。

这类问题的根因通常是把“模式解析”“匹配数量”和“文件访问”压成一个布尔值。把三层拆开后，ErrBadPattern 只负责告诉你模式需要修正，空结果负责表达没有待处理文件，真正的 I/O 和内容问题则由后续步骤给出更准确的错误。

相关问题

Glob 没有匹配项时会返回错误吗？
不会。合法模式没有命中时通常返回空的匹配结果和 nil 错误。

怎样验证一个模式是否合法？
可以调用 filepath.Match 配合一个示例名称先解析模式，真正批量找文件时仍需处理 Glob 的结果。

想记录目录权限错误应该怎么办？
不要只看 Glob；改用能暴露访问错误的遍历路径，再用 filepath.Match 完成模式判断。