Go Doublestar Glob 和 FilepathGlob 的路径分隔符有什么区别

Go Doublestar 里的 Glob 和 FilepathGlob 都能做递归路径匹配，但它们对路径分隔符的假设不同：Glob 面向 io/fs，模式统一使用正斜杠 /；FilepathGlob 是宿主机文件系统的便利封装，会按当前系统处理路径，并让返回值使用系统分隔符。

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

最简单的记法是：模式属于虚拟 FS 时用 Glob，模式属于本机文件路径时用 FilepathGlob。在 Windows 上不要把带反斜杠的本机模式未经转换直接交给 Glob。

先分清两种 API 的输入边界

Glob 的签名包含一个 fs.FS 和一个模式。Doublestar 官方文档明确说明，它和 io/fs.Glob 一样假设模式使用 /，即使宿主系统不是这个分隔符。模式中的路径相对于传入的 FS 根目录解释，适合把扫描根目录和匹配规则分开。

FilepathGlob 不需要调用方准备 fs.FS。它是给不想处理 io/fs 的代码准备的便利函数，内部会清理并转换模式、拆出固定前缀、创建 FS，再调用 Glob，最后把匹配结果与基础路径拼接起来。官方说明它返回的路径会使用系统分隔符，和标准库 filepath.Glob 的习惯一致。

分别写出 Glob 和 FilepathGlob

下面两个函数处理的是同一类“递归匹配 Go 文件”的需求，但代码入口不同。第一段把宿主机目录固定为 FS 根，传给 Glob 的模式只使用正斜杠；第二段直接接收宿主机路径模式。

package matcher

import (
	"fmt"
	"os"

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

// listWithGlob 在指定 FS 根目录内使用统一的 / 分隔符匹配。
func listWithGlob(root string) ([]string, error) {
	// os.DirFS 把本机目录转换成相对路径的 fs.FS 边界。
	fsys := os.DirFS(root)

	// Glob 的模式属于 io/fs，Windows 上也要写成 **/*.go。
	matches, err := doublestar.Glob(fsys, "**/*.go")
	if err != nil {
		// 坏模式是调用错误；匹配不到文件则返回 nil 或空结果而非此错误。
		return nil, fmt.Errorf("glob go files: %w", err)
	}
	return matches, nil
}

// listWithFilepathGlob 直接使用宿主机路径模式并返回本机格式的路径。
func listWithFilepathGlob(pattern string) ([]string, error) {
	// FilepathGlob 会按当前系统清理模式、建立 FS 并拼回基础路径。
	matches, err := doublestar.FilepathGlob(pattern)
	if err != nil {
		return nil, fmt.Errorf("filepath glob: %w", err)
	}
	return matches, nil
}

这不是“一个支持递归、一个不支持递归”的区别。Doublestar 的两者都使用同一套模式能力，关键差别在于路径边界：Glob 把分隔符规则交给 io/fs 语义，FilepathGlob 把本机路径清理和结果格式也纳入函数内部。

按平台处理模式分隔符

在 macOS 或 Linux 上，系统分隔符本身就是 /，因此很多示例看起来没有区别。在 Windows 上，FilepathGlob 可以接收符合本机路径习惯的模式并返回反斜杠路径；而 Glob 仍要求模式按 / 组织。

如果模式来自配置文件、数据库或 HTTP 请求，最稳妥的做法不是猜平台，而是先决定它属于哪种语义。如果它是跨平台保存的逻辑模式，就统一转换为斜杠后调用 Glob；如果它明确是当前机器上的路径，就交给 FilepathGlob。

package matcher

import (
	"fmt"
	"path/filepath"

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

// listPortablePattern 把外部保存的逻辑模式统一成 Glob 能理解的格式。
func listPortablePattern(pattern string) ([]string, error) {
	// ToSlash 只负责把当前系统分隔符转换成 /，不改变 ** 等 glob 元字符。
	fsPattern := filepath.ToSlash(pattern)
	// 这里仍需先确定根目录，再让模式相对于该 FS 根目录解释。
	base, relative := doublestar.SplitPattern(fsPattern)
	matches, err := doublestar.Glob(os.DirFS(base), relative)
	if err != nil {
		return nil, fmt.Errorf("portable glob: %w", err)
	}
	return matches, nil
}

上面的示例强调的是分隔符转换的位置。实际项目还需要补上 os 导入，并根据应用的允许目录策略检查 base；SplitPattern 只负责拆分模式，不是权限隔离。若模式已经明确属于本机路径，则直接使用 FilepathGlob 更简洁。

运行检查与清理边界

检查这类代码时，先看四个问题：模式是否包含 ** 等 Doublestar 语法；模式当前使用的是 / 还是系统分隔符；调用的是哪一个函数；返回值是否要继续交给本机 API。

资源清理也要和入口匹配：Glob 本身只返回匹配名称，不会替调用方打开文件；拿到结果后再由业务代码逐个打开并关闭。模式错误应当向上返回；目录不存在或没有匹配项是否算错误，则按 Doublestar 的默认语义和业务约定处理，不要仅凭“返回空”推断是分隔符问题。

扩展实验与总结

可以用同一组目录分别准备两种模式：逻辑模式写成 pkg/**/*.go，本机模式则写成当前平台路径格式。先确认调用入口，再观察返回路径是 FS 根下的相对名称还是带有本机分隔符的路径。不要把这类比较当成在线验证；它只是帮助代码评审明确输入与输出契约。

• Glob 的关键词是 fs.FS 与正斜杠模式。
• FilepathGlob 的关键词是本机路径清理与系统分隔符返回值。
• 跨平台逻辑模式可用 filepath.ToSlash 统一后再交给 Glob，但要单独审查根目录边界。

相关问题：Linux 上两者返回值为什么看起来一样？因为 Linux 的系统分隔符就是 /，差异主要在 FS 根和输入语义。Windows 上能把反斜杠模式直接传给 Glob 吗？不建议，Glob 按 io/fs 规则使用正斜杠。FilepathGlob 能不能使用 Doublestar 的 **？可以，差别在路径封装和分隔符，不在是否支持递归元字符。