Go问答：path/filepath.Glob通配符路径为什么匹配不到文件为什么结果为空或不符合预期

如果 filepath.Glob 返回空切片，第一步不要急着改成递归遍历：它通常表示模式语法是合法的，但当前模式下没有匹配项；只有模式本身写坏时才会返回 filepath.ErrBadPattern。最常见的根因是相对路径相对于进程当前工作目录、* 没有跨越目录分隔符，或者手写路径时把平台分隔符和转义规则混在了一起。

本文围绕一个批处理场景，把这三类情况拆开，并给出一套可直接放进生产代码的排查写法。官方文档入口：https://pkg.go.dev/path/filepath

先看 Glob 的两个返回值

Glob 的返回值是 matches, err。没有文件符合模式时，matches 为 nil 或空集合，但 err 仍然可能是 nil；模式包含未闭合的字符类等语法问题时，才应按 ErrBadPattern 处理。

package main

import (
	"errors"
	"fmt"
	"path/filepath"
)

func report(pattern string) {
	// 先保留 pattern，生产日志才能还原“到底匹配了什么”。
	matches, err := filepath.Glob(pattern)
	if err != nil {
		// ErrBadPattern 是输入模式错误，不应和“目录中没有文件”混为一谈。
		if errors.Is(err, filepath.ErrBadPattern) {
			fmt.Printf("非法模式 pattern=%q err=%v\n", pattern, err)
			return
		}
		fmt.Printf("扫描失败 pattern=%q err=%v\n", pattern, err)
		return
	}

	if len(matches) == 0 {
		// 合法模式没有命中；这里交给业务决定是跳过、告警还是报错。
		fmt.Printf("没有匹配文件 pattern=%q\n", pattern)
		return
	}
	fmt.Printf("命中 %d 个文件 pattern=%q\n", len(matches), pattern)
}

func main() {
	report("data/*.csv")
	report("data/[broken.csv")
}

这段判断先解决了最容易误判的地方：空结果不是 API 失败。如果业务要求“本批必须至少有一个 CSV”，可以在 len(matches) == 0 分支返回业务错误；如果目录允许暂时为空，就记录上下文后继续。

相对路径其实依赖当前工作目录

filepath.Glob("data/*.csv") 不会把路径解释成源码文件所在目录，也不会自动使用项目根目录。它依赖进程启动时的当前工作目录。服务由 systemd、容器或任务调度器启动时，当前目录很可能和本地终端不同，于是文件确实存在，但不在这次模式所指向的目录里。

package main

import (
	"fmt"
	"os"
	"path/filepath"
)

func main() {
	// 显式打印工作目录，排查“本地能匹配、服务里为空”的差异。
	wd, err := os.Getwd()
	if err != nil {
		panic(fmt.Errorf("读取工作目录失败: %w", err))
	}

	base := filepath.Join(wd, "data")
	pattern := filepath.Join(base, "*.csv")
	// Join 负责平台分隔符，pattern 只表达文件名规则。
	matches, err := filepath.Glob(pattern)
	if err != nil {
		panic(fmt.Errorf("glob pattern=%q: %w", pattern, err))
	}
	fmt.Printf("cwd=%q pattern=%q matches=%d\n", wd, pattern, len(matches))
}

如果程序配置里已经有数据目录，优先使用配置提供的绝对路径；如果必须接收相对路径，建议在入口处把它相对于明确的 base 目录解析一次，后续日志同时记录最终的绝对 pattern。

* 不会跨越路径分隔符

Shell 风格模式中，* 匹配的是当前路径段中的任意字符，不会从 data/2026/01/a.csv 跨过目录分隔符一路匹配。也就是说，data/*.csv 只看 data 的直接子项；需要两层目录时，必须把层级写出来，或者改用 WalkDir 做递归遍历。

这也是为什么“目录里明明有文件”仍然得到空结果：文件存在性和模式覆盖范围是两个问题。

使用 filepath.Join 组合通配符路径

不要把用户输入、目录名和通配符直接用字符串加号拼接。用 filepath.Join 组合固定目录和模式后，能减少 Unix 与 Windows 分隔符差异导致的错误。

func globCSV(baseDir, year string) ([]string, error) {
	// year 只作为一个目录段使用，通配符放在最后一个文件名段。
	pattern := filepath.Join(baseDir, year, "*.csv")
	matches, err := filepath.Glob(pattern)
	if err != nil {
		// 把实际模式带回调用方，便于定位非法字符或未闭合括号。
		return nil, fmt.Errorf("glob %q: %w", pattern, err)
	}
	// 空集合是合法结果，由调用方决定是否需要返回业务错误。
	return matches, nil
}

如果目录名来自外部输入，还要在业务层限制它的范围；Join 负责路径组合，但不会替你完成权限策略、符号链接检查或目录白名单。

特殊字符与平台差异怎么处理

filepath.Match 使用 Shell 风格模式：* 匹配非分隔符字符，? 匹配一个非分隔符字符，方括号表示字符类。Unix 下反斜杠可以参与转义；Windows 下反斜杠本身是路径分隔符，不能照搬 Unix 的转义写法。因此，跨平台代码不要手写类似 data\\*.csv 来表达同一件事，而应让 Join 生成路径分隔符。

需要匹配文件名中的字面 * 或 [ 时，先确认目标平台的模式规则，再使用 Match 做单元测试。不要把 Glob 当成正则表达式：它没有 .*、捕获组或正则转义语义。

生产环境的最小排查清单

1. 记录最终的 pattern，不要只记录配置里的相对目录。
2. 记录 os.Getwd() 与 len(matches)，先判断是不是工作目录变化。
3. 遇到错误时单独识别 filepath.ErrBadPattern，不要把它当成空目录。
4. 确认每个 * 只覆盖一个路径段；需要递归时改用 WalkDir 或显式列出层级。
5. 对外部目录和文件名做白名单或本地路径约束，避免把路径组合当成安全校验。

结论可以压缩成一句话：Glob 匹配不到文件时，先看“模式指向的目录”和“通配符覆盖的层级”，再看转义；只有拿到 ErrBadPattern 才需要修正模式语法。把 pattern、工作目录、匹配数量和错误类型一起记录，通常一次日志就能定位问题。

相关问题

filepath.Glob 会递归子目录吗？

不会。模式中的每个路径段都按当前平台分隔符分开，* 不会跨越分隔符。递归扫描应考虑 filepath.WalkDir。

没有匹配文件时为什么没有 error？

空匹配是合法结果，Glob 只把非法模式报告为 ErrBadPattern。业务是否允许空集合，需要由调用方决定。

为什么本地能匹配，部署后却为空？

最先检查进程当前工作目录、配置中的 base 目录和容器内实际挂载路径。相对模式不会自动跟随源码目录。