Go filepath.Glob 模式错误为何只返回空结果

filepath.Glob 遇到非法模式，并不是只返回空结果，它会返回 filepath.ErrBadPattern。如果代码写成 matches, _ := filepath.Glob(pattern)，错误就被丢弃，看上去才像普通的“没有匹配”。应先处理err，再判断匹配数量。另一个容易混淆的事实是：Glob会忽略读取目录等文件系统错误，因此err为nil也不能证明所有相关目录都读取成功。

官方地址：https://pkg.go.dev/path/filepath

模式非法真的只返回空结果吗

假设一个离线资料导入工具允许管理员输入文件模式。输入 imports/[ 与输入 imports/*.note，如果界面都只显示“找到0项”，管理员就无法知道该改模式，还是该看目录。前者的左方括号没有闭合，是语法问题；后者语法可以成立，但匹配结果依赖实际目录和文件。

API的两个返回值承担不同职责：matches表达匹配到的路径；err表达模式是否存在能够报告的语法错误。不要以匹配切片为空代替错误判断，也不要为了让列表显示为空而吞掉错误。

最小写法怎样保留错误信息

下面的原创代码保留原模式用于诊断，先分离语法错误，再处理无匹配。它只是供读者复现的示例，没有声称本文已在本机创建相应目录或运行命令。

package main

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

func listMatches(pattern string) error {
    matches, err := filepath.Glob(pattern)
    if err != nil {
        // 先报告语法错误，不把它伪装成正常的空列表。
        if errors.Is(err, filepath.ErrBadPattern) {
            return fmt.Errorf("文件模式语法无效 %q: %w", pattern, err)
        }
        return fmt.Errorf("匹配模式失败 %q: %w", pattern, err)
    }
    if len(matches) == 0 {
        // 无匹配不等于已经排除了目录不可读等文件系统问题。
        fmt.Printf("没有匹配项，模式=%q\n", pattern)
        return nil
    }
    for _, name := range matches {
        fmt.Println(name)
    }
    return nil
}

func main() {
    // Join只负责组装平台路径，不会替你修复模式语法。
    pattern := filepath.Join("imports", "*.note")
    if err := listMatches(pattern); err != nil {
        fmt.Fprintln(os.Stderr, err)
        os.Exit(1)
    }
}

这里针对ErrBadPattern的分支，目的是给用户准确提示；其余分支保留一般错误处理结构。按当前Glob契约，返回错误只可能是模式错误。示例不把“无匹配”定义为应用失败，如果你的业务要求至少一份文件，可以在空列表分支返回自定义业务错误，但要写成“没有可用输入”，不要写成“模式非法”。

怎样区分三种没有找到

相对模式以进程当前工作目录为基础，不自动以源码目录或可执行文件目录为基础。排查时可以在自己的应用里记录工作目录和实际模式，注意避免把敏感完整路径展示给不该看到的人。打印出的模式要能看出转义与空白字符，使用格式化的%q通常比裸字符串更清楚。

如果业务必须知道某个目录是否读取失败，应采用能报告相应错误的目录读取或遍历方式。单独预查一次目录，也不能保证后续匹配期间文件系统没有发生变化。Glob适合简便地搜集匹配项，不应承担完整的文件系统健康诊断。

哪些模式最容易被误解

Glob采用filepath.Match一类的文件名模式语法，不是正则表达式。星号匹配不含路径分隔符的字符序列；问号匹配一个非分隔符字符；方括号表达字符类。合法模式不等于符合业务预期，例如以为星号会自动穿过多层目录，就可能一直得到空列表。

**没有在这里获得自动递归所有后代目录的特殊含义。需要递归发现文件时，应显式选择目录遍历方案，而不是反复给模式添加星号。Windows上反斜杠作为路径分隔符使用，不能把Unix上的反斜杠转义写法直接照搬。跨平台程序应按目标平台的路径规则组织模式。

nil切片与空切片需要分开判断吗？

如果只是判断有没有匹配，使用len(matches)==0即可。错误必须通过err单独判断，不能靠nil值猜测原因。

Glob会先调用系统shell展开模式吗？

这里的函数由Go库处理传入模式。命令行参数是否已经被外部shell展开，是调用程序之前的另一层问题，应先确认程序实际收到的字符串。

找到路径是否就能保证随后打开成功？

不能。匹配与打开发生在不同操作中，文件可能被移动或权限可能改变。实际打开、读取时仍应处理各自的错误。

参考：Glob官方契约、Match模式语法。