Go path 怎样用 Match 判断资源名通配符

Go 判断资源名是否符合通配符，可以直接调用 path.Match(pattern, name)。它要求模式匹配整个资源名，而不是只在字符串中找到一段；其中 * 和 ? 都不会跨过斜杠。先把资源名限定为 URL 或其他使用正斜杠的逻辑路径，再根据层级写模式，通常就能避免“目录也被匹配进去”的误判。

官方地址：https://pkg.go.dev/path@go1.27.3#Match

最小决策是：资源名使用正斜杠且只需要 shell 风格的有限通配时用 path.Match；需要操作系统文件路径时改看 path/filepath。无论哪种情况，都要检查返回的错误，因为非法模式和“不匹配”是两种不同结果。

• 匹配范围：必须覆盖整个 name，不是子串搜索。
• 层级边界：*、? 和字符类都不能匹配 /。
• 错误含义：只有模式格式错误时才返回 path.ErrBadPattern。
• 路径类型：path 面向正斜杠资源名，操作系统文件路径应使用 filepath 系列 API。

先确定资源名属于哪种路径

path 包面向用正斜杠分隔的路径，例如 URL 或应用内部的资源键；它不处理带盘符和反斜杠的 Windows 路径。如果业务数据是 static/app.js、images/logo.svg 这类逻辑资源名，模式和输入应保持同一种斜杠约定，不要一边把它当 URL，一边用本机文件路径的字符串规则去拼接。

用 Match 判断完整资源名

调用时同时接住布尔结果和错误。布尔值为 false 且错误为 nil，表示模式合法但资源名不符合；错误非空则表示模式本身不能使用，不能把它当成普通“不匹配”继续缓存。

package main

import (
	"errors"
	"fmt"
	"path"
)

func main() {
	cases := []struct {
		pattern string
		name    string
	}{
		{"assets/*.js", "assets/app.js"},
		{"assets/*.js", "assets/vendor/app.js"},
		{"assets/v?.json", "assets/v1.json"},
	}

	for _, item := range cases {
		matched, err := path.Match(item.pattern, item.name)
		if err != nil {
			// 模式错误属于配置输入问题，应与正常不匹配分开处理。
			if errors.Is(err, path.ErrBadPattern) {
				fmt.Printf("invalid pattern %q: %v\n", item.pattern, err)
				continue
			}
		}
		fmt.Printf("pattern=%q name=%q matched=%t\n", item.pattern, item.name, matched)
	}
}

第一组会匹配，第二组不会匹配，因为 * 不能跨过 /；第三组会匹配一个字符的版本名。这里的示例输出是根据文档规则推导出的预期结果，不把文章中的代码块描述成已经执行过的日志。

如果模式来自配置文件、数据库或用户输入，建议在加载配置时就调用一次 path.Match 做语法分流；请求处理阶段只接收已经确认合法的模式。这样能把“配置写坏”和“资源名不符合”分别归因，也便于记录实际使用的 pattern。

通配符怎样控制资源层级

path.Match 使用的是 shell 风格模式：* 匹配任意长度的非斜杠字符，? 匹配一个非斜杠字符，[a-z] 表示字符范围，[^0-9] 表示排除字符类。模式必须匹配完整的 name，所以 *.css 能匹配 main.css，但不能匹配 css/main.css。

需要把目录层级写进模式时，显式放置斜杠即可，例如 static/*.css 只覆盖 static 这一层；如果还要匹配 static/theme/dark.css，就不能只把 * 想象成递归通配符，而应重新设计资源键或分层判断逻辑。

非法模式与落地清单

模式末尾出现未配对的 [、不完整的转义，或字符类结构不合法时，返回的错误是 path.ErrBadPattern。它表示 pattern 需要修复；而合法模式面对不同资源名返回 false, nil，表示筛选条件没有命中。两者在监控、配置提示和重试策略上不应混为一谈。

1. 确认输入是 URL 或逻辑资源名，并统一使用正斜杠。
2. 把目录层级写进 pattern，不把 * 当递归通配符。
3. 同时处理 matched 与 err，先判断错误再使用匹配结果。
4. 为精确名、同层文件、跨层文件和非法模式各准备一个边界用例。
5. 如果目标是本机文件路径，改用 path/filepath 并按操作系统规则处理。

常见问题

path.Match 是不是正则表达式？

不是。它实现的是受限的 shell 风格模式，支持 *、?、字符类和转义，不支持把正则表达式的全部语法直接塞进去。

为什么 *.json 匹配不到 data/a.json？

因为星号不能匹配斜杠，且 Match 要求整个资源名都被模式覆盖。可以使用包含目录的模式，或者先按资源层级拆开处理，但不要把星号当成递归匹配。

返回 false 时需要重试吗？

不需要。false, nil 表示模式合法但当前名称不符合；只有返回 path.ErrBadPattern 时才应修复或拒绝该模式。

Windows 文件名也能直接用 path.Match 吗？

不建议。path 的约定是正斜杠分隔的逻辑路径，Windows 文件路径应使用 path/filepath 中与操作系统路径相匹配的函数。

把资源名的命名空间、通配符的层级边界和错误语义分开，path.Match 就适合做轻量的资源筛选；如果需求已经变成正则表达式、递归文件遍历或跨平台本机路径处理，应换用更贴合任务的工具。