Go Doublestar 怎样只匹配指定目录下的多层文件

如果你只想在 configs 目录及其子目录中查找 YAML 文件，关键不是把模式写成一个很宽的 **/*.yaml，而是把目标根目录放到模式前面：configs/**/*.yaml。Doublestar 会把 ** 当作独立路径段递归展开，前面的目录名则把匹配范围限制在指定目录内。

官方地址：https://github.com/bmatcuk/doublestar

先看清楚“指定目录”到底由哪一段保证

现场通常是这样的：项目根目录下同时有 configs、vendor 和临时导出目录，需求只允许读取 configs 下任意深度的 YAML。此时模式应当是 configs/**/*.yaml，而不是先用 **/*.yaml 找全项目再在 Go 代码里过滤。

Doublestar 的 ** 只有在独立路径段中才具有递归含义。configs/**/app.yaml 可以匹配 configs/app.yaml 和更深层目录里的同名文件；configs/app**.yaml 则不是同一种递归表达。另一个边界是：configs/** 可以返回目录和文件，若只要文件，应在选项或回调层明确过滤。

用 Glob 匹配指定目录下的多层文件

一次性收集结果时，可以调用 doublestar.FilepathGlob。它适合直接接收本机路径；如果你的模式和路径统一使用正斜杠，也可以使用基于 io/fs 的 Glob。下面的例子保留本机目录写法，并用 WithFilesOnly 排除目录结果。

# 创建示例模块；实际项目也可以在已有 go.mod 中执行安装。
mkdir doublestar-scope-demo
cd doublestar-scope-demo
go mod init example.com/doublestar-scope-demo
go get github.com/bmatcuk/doublestar/v4

package main

import (
	"fmt"
	"path/filepath"

	"github.com/bmatcuk/doublestar/v4"
)

func findYAML(root string) ([]string, error) {
	// 先清理根目录，避免拼接出多余的分隔符或空根路径。
	root = filepath.Clean(root)
	// ** 必须是独立路径段，root 决定递归搜索的边界。
	pattern := filepath.Join(root, "**", "*.yaml")

	// FilepathGlob 使用操作系统路径分隔符，适合本机文件系统。
	return doublestar.FilepathGlob(pattern, doublestar.WithFilesOnly())
}

func main() {
	files, err := findYAML("configs")
	if err != nil {
		// 坏模式或遍历错误都要交给调用方，不能把空结果当成成功。
		panic(err)
	}
	for _, file := range files {
		fmt.Println(file)
	}
}

这里的 root 是限制范围的关键：把它替换成 configs/prod，就只会向该目录及其下级目录匹配。WithFilesOnly 让调用方不必再为目录结果写一层判断；如果符号链接是否跟随会影响结果，还应根据需求考虑 WithNoFollow。

路径分隔符和 Match 选择不要混在一起

我排查这类问题时，第二个猜测通常是“模式写对了，但 Windows 上怎么匹配不到”。原因常常是把 Match 当成了 filepath.Match 的跨平台版本。Doublestar 的 Match 以正斜杠分段；本机路径由系统分隔符决定时，应使用 PathMatch，或者先把两边都转换为 slash 再使用 Match。

func matchesYAML(root, name string) (bool, error) {
	// 统一为 slash 后再调用 Match，适合模式和名称需要跨平台传输的场景。
	pattern := filepath.ToSlash(filepath.Join(root, "**", "*.yaml"))
	normalizedName := filepath.ToSlash(name)

	// Match 要求完整匹配，不是只匹配 name 的一段子串。
	return doublestar.Match(pattern, normalizedName)
}

如果模式和文件名始终都是当前系统的本机路径，则直接使用 doublestar.PathMatch 更自然。不要一边把模式保留成反斜杠，一边又拿只理解正斜杠分段的 Match 去判断。

需要边遍历边处理时改用 GlobWalk

配置文件很多时，把所有路径一次性放进切片并不是唯一选择。GlobWalk 可以在遍历过程中回调，每次拿到一个 DirEntry 就处理或停止。下面的例子只统计指定目录内的 YAML 文件，并对遍历错误返回明确结果。

func countYAML(fsys fs.FS, root string) (int, error) {
	count := 0
	// fs.FS 的路径使用 slash，因此模式保持 root/**/*.yaml。
	pattern := path.Join(root, "**", "*.yaml")

	err := doublestar.GlobWalk(fsys, pattern, func(path string, d fs.DirEntry) error {
		// WithFilesOnly 不适用于回调筛选时的所有业务规则，这里仍明确检查目录。
		if d.IsDir() {
			return nil
		}
		count++
		return nil
	}, doublestar.WithFilesOnly(), doublestar.WithFailOnIOErrors())
	return count, err
}

这段代码使用 fs.FS，所以示例中需要导入 io/fs 和 path。WithFailOnIOErrors 的作用是遇到 I/O 问题就中止；“目录存在但没有匹配项”仍然应按空结果理解，而不是伪造一个文件。

最后按结果和错误边界复查

这次问题可以收敛成一句话：先用目录前缀限定搜索根，再用独立的 ** 表示任意层级，最后根据一次性收集还是流式消费选择 Glob 或 GlobWalk。路径跨平台时，把分隔符策略提前定下来，排查会快很多。

常见问题

configs/**/*.yaml 会匹配 configs 根目录下的文件吗？

按照 Doublestar 的 globstar 语义，** 可以匹配零层或多层目录，因此可以覆盖 configs/app.yaml 以及更深目录中的同类文件。

只想要文件，为什么还会看到目录？

** 本身也能匹配目录。使用 WithFilesOnly，或在 GlobWalk 回调里通过 DirEntry.IsDir() 排除目录。

什么时候使用 Match 而不是 PathMatch？

模式与名称都使用 slash、需要跨平台传输时可先调用 filepath.ToSlash 再使用 Match；始终使用本机分隔符时，优先考虑 PathMatch。

指定目录递归匹配的核心不是扩大通配符，而是把边界写进模式：root/**/*.ext。在此基础上，再用文件过滤、路径分隔符和错误处理把结果收紧，Doublestar 才能稳定地服务于配置扫描、资源索引或批量导入场景。