Go filepath.Match 处理方括号模式的转义规则

用 filepath.Match 过滤文件名时，真正容易出错的不是 *，而是方括号里的 -、] 和反斜杠。结论先说：字符类写成 [a-z] 时表示区间，想匹配字面量特殊字符要按 Match 的模式语法转义；但在 Windows 上反斜杠是路径分隔符，不能把 Unix 的转义写法原样搬过去。

官方参考：https://pkg.go.dev/path/filepath#Match

一、先把方括号字符类拆成四种情况

Match 要求整个 name 都被模式匹配。方括号表达一个字符类：单个字符直接列出，lo-hi 表示 Unicode 字符值范围，开头的 ^ 表示取反。例如 [abc] 只接收 a、b、c，[0-9] 接收一个数字，[^/] 则表示一个不是分隔符的字符。

二、先分清 Go 字符串层和 Match 模式层

写在 Go 源码里的 "[\\-]"，需要先经过 Go 字符串解析，传给 Match 的才是 [\-]。如果用反引号原始字符串，就能直接看到传入模式，调试时更直观：

package main

import (
	"fmt"
	"path/filepath"
)

func main() {
	patterns := []struct {
		pattern string
		name    string
	}{
		{`[a-z]`, "m"},       // 字符区间只匹配一个小写字母
		{`[\-]`, "-"},        // Unix 模式中把连字符当作字面量
		{`[^0-9]`, "x"},       // 取反字符类排除数字
	}

	for _, item := range patterns {
		matched, err := filepath.Match(item.pattern, item.name)
		if err != nil {
			// ErrBadPattern 表示模式本身无效，不要把它当成“不匹配”。
			fmt.Printf("%q -> error: %v\\n", item.pattern, err)
			continue
		}
		fmt.Printf("%q vs %q -> %v\\n", item.pattern, item.name, matched)
	}
}

这里的 [a-z] 不会匹配多字符 abc；Match 的字符类每次消耗一个字符，且模式最终必须消耗完输入。需要匹配整段文件名时，要把字符类和 *、普通后缀组合起来。

三、处理 ]、- 和格式错误时不要靠猜

在字符类里，- 可能表示区间，] 负责结束字符类，末尾反斜杠也可能让模式不完整。不要只看 matched == false：调用方应同时检查 err，因为格式错误和合法的不匹配是两种不同状态。

package main

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

func check(pattern, name string) {
	matched, err := filepath.Match(pattern, name)
	if errors.Is(err, filepath.ErrBadPattern) {
		// 语法错误应回到配置或输入清洗环节修复。
		fmt.Printf("pattern=%q is invalid\\n", pattern)
		return
	}
	if err != nil {
		// 保留未知错误，避免把异常静默成普通不匹配。
		fmt.Printf("pattern=%q failed: %v\\n", pattern, err)
		return
	}
	fmt.Printf("pattern=%q name=%q matched=%v\\n", pattern, name, matched)
}

func main() {
	check(`[a-]`, "a")   // 区间缺少右端点，属于坏模式
	check(`[a-z]`, "go") // 模式只有一个字符位，完整匹配会返回 false
}

工程上建议把外部配置的 pattern 在加载阶段集中检查，再将合法模式交给遍历逻辑。这样文件扫描失败时能区分“用户输入写错”和“目录里没有符合项”。

四、Unix 与 Windows 的反斜杠边界

官方文档明确说明：Unix 上反斜杠可以转义字符；Windows 上 escaping disabled，反斜杠会被当作路径分隔符。因此 [\-] 这种写法只能作为 Unix 语境下的模式示例。若配置要跨平台共享，不要把反斜杠当成通用的字面量转义协议。

更稳妥的做法是先限定配置格式：如果只需要匹配扩展名，使用 *.go 这类不依赖反斜杠的模式；如果必须匹配字面量方括号或连字符，按目标操作系统分别生成模式，并为每个平台保留回归用例。

package main

import (
	"fmt"
	"path/filepath"
)

func main() {
	cases := []struct {
		pattern string
		name    string
	}{
		{`report-[0-9].txt`, "report-7.txt"}, // 区间匹配一个数字
		{`report-[0-9].txt`, "report-77.txt"}, // 两位数字不符合单字符位置
		{`*.go`, "cmd/main.go"},              // * 不跨越路径分隔符
	}
	for _, tc := range cases {
		ok, err := filepath.Match(tc.pattern, tc.name)
		fmt.Printf("%q / %q => %v, %v\\n", tc.pattern, tc.name, ok, err)
	}
}

常见问题

filepath.Match 为什么匹配不到带斜杠的路径？

* 和 ? 都不能匹配路径分隔符，而且 Match 要求完整匹配。多层目录应按分隔符拆成多个片段，或改用 filepath.Glob。

方括号为空时为什么返回 ErrBadPattern？

字符类必须至少包含一个有效字符或区间。空类没有明确匹配集合，属于格式错误，不是普通的 false。

能否用 filepath.Match 解析任意正则表达式？

不能。它实现的是 shell 文件名模式，只有 *、?、字符类和有限转义；需要正则语义时应使用 regexp 包，并重新设计路径分隔符处理。