Go io/fs.Glob 怎样按模式匹配文件系统路径

用 fs.Glob(fsys, pattern) 可以在指定的 fs.FS 内查找匹配路径。pattern 使用 path.Match 的模式语法，以正斜杠分隔层级；例如 templates/*.tmpl 匹配 templates 目录直接包含的 tmpl 条目，不会递归匹配任意深度。

官方文档：https://pkg.go.dev/io/fs#Glob

触发信号：模板列表突然为空

以部署后模板发现为空为例，我会先把问题拆成三项：文件系统根是否改变、模式层级是否匹配、部署包里是否带上模板。这是本文设定的排障场景，不是一次实际线上事故记录。

一个容易误判的地方是 err 为 nil。Glob 会忽略读取目录等文件系统错误，正常返回并不证明文件都可读取；空结果也不能直接证明目录里没有文件。它适合发现候选路径，不是权限探测或完整性检查工具。

快速判断：先固定 fs.FS 的根

假设宿主机的 assets 目录被映射为 fs.FS 根，那么它内部的 templates/report.tmpl，在模式中就写 templates/report.tmpl，不应再把 assets 前缀加一遍。普通路径名采用相对根的写法，不以斜杠开头，也不要写 ./ 或 .. 路径元素。

若使用 embed.FS，根取决于嵌入后暴露的路径；若使用 fs.Sub 得到子文件系统，模式又要相对新的根。排障时先记清“当前 fsys 根”，再检查模式，通常比不停替换通配符更有效。

处理步骤：从最小匹配代码开始

下面使用内存文件系统构造独立样例，不依赖某台机器的目录。示例匹配 templates 下的直接子项；返回的名字仍属于同一个 fsys 命名空间，可继续交给 fs.ReadFile。

package main

import (
    "fmt"
    "io/fs"
    "log"
    "testing/fstest"
)

func main() {
    tree := fstest.MapFS{
        "templates/report.tmpl": {Data: []byte("报告")},
        "templates/readme.txt": {Data: []byte("说明")},
        "templates/mail/notice.tmpl": {Data: []byte("通知")},
    }
    // 星号不跨越斜杠，只发现这一层的模板。
    names, err := fs.Glob(tree, "templates/*.tmpl")
    if err != nil {
        log.Fatal(err)
    }
    if len(names) == 0 {
        log.Fatal("没有找到预期模板")
    }
    for _, name := range names {
        // 匹配成功不等于读取成功，每个实际读取仍需处理错误。
        data, err := fs.ReadFile(tree, name)
        if err != nil {
            log.Fatal(err)
        }
        fmt.Printf("%s: %s\n", name, data)
    }
}

按示例语义，report.tmpl 应被选中，readme.txt 后缀不匹配，mail/notice.tmpl 则多了一层目录。本文没有运行此例，也没有展示伪造日志。读取使用 fs.ReadFile，不向调用方暴露需要手动关闭的文件句柄。

模式速查：星号不是任意深度

** 在这里没有“递归所有层”的扩展语义。需要任意深度时，可以改用 fs.WalkDir 并在回调中筛选；若需求只是固定深度，直接把层级写清楚更直观。Glob 也没有 shell 的花括号展开或环境变量展开。

名称分隔符统一使用 /，不要为了 Windows 把模式拼成反斜杠路径。pattern 中反斜杠承担转义语义，宿主系统目录路径和 fs.FS 内部名称属于不同层次。

错误与空结果：分开处理

模式写坏时，Glob 报告 path.ErrBadPattern。没有匹配项时，返回 nil 切片和 nil 错误。调用方用 len(names) == 0 判断是否为空，不必把 nil 与空切片区分成两种业务状态。

对必须存在的启动模板，我倾向于把空结果当作启动失败，给出根目录标识、模式和部署版本等可定位信息；可选插件则可以约定为空时跳过。这是业务选择，不能把一个通用的空结果强行解释为服务正常。

回退路径与复盘项

如果变更后必需模板无法发现，先保留失败信号，再恢复上一份已知可用的部署内容与根目录配置。不要把模式改成 * 并直接加载所有匹配项，这可能把目录或非模板文件也交给加载器。Glob 匹配的是名字，不保证条目一定是普通文件，必要时用 fs.Stat 和文件类型规则筛选。

若排障目标是获得底层错误，直接对预期目录调用 fs.ReadDir、对确定文件调用 fs.ReadFile，或使用能够处理遍历错误的 WalkDir。不要依赖 Glob 返回权限错误。自定义文件系统若实现 GlobFS，fs.Glob 会委托其 Glob 方法，因此也应理解该实现的接口行为。

复盘时保留根目录来源、期望层级、是否允许空集合、实际读取错误处理和部署资源清单。这些是项目排障建议；本文没有声称已在生产环境验证通过。

相关问题

匹配完以后文件还可能消失吗？

可能。可变文件系统中的发现与读取不是事务，实际读取仍需处理错误。

能把返回名称交给 os.ReadFile 吗？

不要直接假设可以。它们相对 fsys 根，优先交给 fs.ReadFile(fsys, name)；只有明确宿主路径映射后才转换。

只有一个固定文件，也需要写通配符吗？

不需要。如果必须取得该文件并准确报告读取错误，直接 fs.ReadFile 更清楚；Glob 没有替代文件读取的错误契约。

参考：fs.Glob 文档、path.Match 模式语法。