Go filepath.Match 中的方括号如何匹配文件名

用 Go 的 filepath.Match 按文件名筛选时，方括号表示的是“一个字符的集合”，不是任意长度的字符串。比如 [ab] 能匹配 a 或 b，[a-c] 能匹配 a、b、c；模式仍然必须覆盖整个文件名。掌握这个宽度规则，再处理范围、反向类和跨平台转义，就不容易把 Match 写成正则表达式。

一、方括号一次只匹配一个字符

filepath.Match 的方括号语法对应 shell 文件名模式。最小写法是 [ab]：它在当前位置接受 a 或 b，但不会把 ab 当成两个候选字符。因此，report[ab].csv 可以匹配 reporta.csv 和 reportb.csv，不能匹配 reportab.csv。

还要注意，Match 不是“查找子串”。模式末尾的 .csv 也必须对应文件名末尾；如果希望星号跨过任意数量的非分隔符字符，应明确写成 *。方括号本身只负责当前位置的一个字符。

二、用横线写范围，用 ^ 排除字符

字符类里可以写范围，例如 [a-c] 表示从 a 到 c 的一个字符。多个范围可以组合，像 [0-9A-F] 表示数字或大写十六进制字母。范围描述的是字符区间，不是字符串区间，所以它仍然只匹配一个字符。

把 ^ 放在左方括号后，可以得到反向字符类。例如 report[^0-9].csv 接受 reportx.csv，但拒绝 report7.csv。[^] 这类空字符类没有有效匹配项，写错的闭合方括号、缺少结束方括号等情况会让模式变成坏模式，而不是一次普通的“不匹配”。

下面的示例把三种结果放在一起。代码中的注释说明了判断顺序；示例只展示模式语义，不代表文章配图中的真实运行截图。

package main

import (
	"fmt"
	"path/filepath"
)

func main() {
	tests := []struct {
		pattern string
		name    string
	}{
		{"report[ab].csv", "reporta.csv"},
		{"report[a-c].csv", "reportd.csv"},
		{"report[^0-9].csv", "report7.csv"},
	}

	for _, test := range tests {
		matched, err := filepath.Match(test.pattern, test.name)
		// 先区分模式语法错误，再判断合法模式是否命中完整文件名。
		fmt.Printf("pattern=%q name=%q matched=%v err=%v\\n", test.pattern, test.name, matched, err)
	}
}

三、Go 字符串和跨平台转义要分开看

模式里的反斜杠和 Go 源码里的字符串转义是两层规则。若要在 Unix 风格环境中把特殊字符当作字面量，解释字符串可能需要写成 "\\\\["，原始字符串则可以写成 \`\\[\`；实际选择取决于你要匹配的字符和目标系统。不要只看源码里出现了几个反斜杠，要先还原传给 Match 的实际字符串。

更重要的是跨平台差异：filepath 使用目标系统的 Separator 分隔路径；在 Windows 上反斜杠承担路径分隔符角色，转义行为与 Unix 不同。路径模式不要把 / 和 \\ 随意拼接，目录层级可以用 filepath.Join 组合，单个文件名的字符类再交给 Match 判断。

如果模式包含用户输入，先定义允许的文件名边界，再决定是否需要转义；不要把 Match 当成正则表达式，也不要用它验证完整路径中的任意目录层级。它的通配符不会越过路径分隔符。

四、把 Match 的 bool 和错误值一起处理

Match 返回两个值：matched 表示合法模式是否完整匹配，err 只在模式格式错误时提供原因。合法但没有命中的例子是 false, nil；因此不能只写 if !matched 就把所有情况都归为“文件名不符合”。

在批量筛选里，建议先处理错误，再处理布尔值：

matched, err := filepath.Match(pattern, name)
if err != nil {
	// ErrBadPattern 表示调用方给出的模式无法解析，应修正配置或输入。
	if err == filepath.ErrBadPattern {
		return fmt.Errorf("invalid filename pattern %q: %w", pattern, err)
	}
	return err
}
if !matched {
	// 合法模式没有命中，这是正常筛选结果，不是语法故障。
	return nil
}
// matched 为 true 时，name 已经完整符合 pattern。
return process(name)

如果目标是读取目录中所有符合模式的路径，可以使用 filepath.Glob；它沿用相同的模式语法，并把遍历目录和返回匹配项的工作也做了。只比较一个已经拿到的文件名时，Match 更直接。

相关问题

方括号能匹配多个连续字符吗？

不能。它只匹配一个字符；多个连续字符需要多个模式项，或根据需求使用 *。

模式合法但没有匹配时会返回错误吗？

不会。此时通常是 matched=false、err=nil；只有模式结构非法才检查 filepath.ErrBadPattern。

filepath.Match 可以替代正则表达式吗？

不能直接替代。它面向 shell 风格文件名模式，不支持正则表达式的分组、捕获和量词；文件名筛选优先用它，文本模式分析则选择正则表达式包。