Go Doublestar 怎样用 GlobWalk 边遍历边处理匹配项

如果目录树很大，又不想先把所有匹配路径装进切片，Go Doublestar 的 GlobWalk 适合做“匹配一个就处理一个”。它接收 fs.FS、glob 模式和回调，回调拿到路径与 fs.DirEntry；返回 doublestar.SkipDir 可以停止当前目录递归，返回其他错误则立即结束遍历。

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

核心写法是：先用 os.DirFS 把根目录限制在一个文件系统边界内，再用 **/*.go 做第一轮筛选，最后在回调中根据文件名、类型或业务条件处理匹配项。需要完整结果切片时才选 Glob；需要系统路径分隔符兼容时，再考虑 FilepathGlob。

先把 GlobWalk 的三个输入接起来

Doublestar v4 使用 io/fs 接口。下面的例子把 ./workspace 作为遍历根，而不是把绝对路径直接拼进模式；模式中的分隔符使用正斜杠，匹配 src 下任意层级的 Go 文件。代码只演示结构关系，不代表已经在本机执行过。

package main

import (
    "fmt"
    "io/fs"
    "os"

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

func main() {
    // os.DirFS 把遍历范围固定在 workspace，回调收到的是 FS 内的相对路径。
    fsys := os.DirFS("./workspace")

    err := doublestar.GlobWalk(fsys, "src/**/*.go", func(path string, d fs.DirEntry) error {
        // 先排除目录，避免把目录当作待处理文件交给业务逻辑。
        if d.IsDir() {
            return nil
        }
        // 这里可以替换成解析、索引或摘要动作；错误要继续向外传递。
        fmt.Println("matched:", path)
        return nil
    })
    if err != nil {
        // 模式错误和回调错误都在这里统一处理。
        panic(err)
    }
}

在回调里过滤文件并控制递归边界

GlobWalk 的价值不只是省掉结果切片，还能让处理动作和遍历同时发生。比如只处理 .go 文件，遇到缓存目录直接跳过；如果发现关键文件，也可以返回自定义错误，让上层知道是“主动停止”，而不是把它当成扫描失败。

var stopAfterTarget = errors.New("target found")

err := doublestar.GlobWalk(fsys, "**/*", func(path string, d fs.DirEntry) error {
    // 缓存目录不需要进入，SkipDir 只影响当前目录的后续递归。
    if d.IsDir() && d.Name() == ".cache" {
        return doublestar.SkipDir
    }
    // 目录项先做类型筛选，再进行业务处理，避免误读目录。
    if !d.IsDir() && strings.HasSuffix(d.Name(), ".go") {
        if err := indexSource(path); err != nil {
            return err
        }
        if d.Name() == "entry.go" {
            // 自定义错误表示达到业务目标，交给外层决定是否算成功。
            return stopAfterTarget
        }
    }
    return nil
})
if errors.Is(err, stopAfterTarget) {
    // 主动停止不是遍历器内部故障，可转成正常的业务分支。
    fmt.Println("target reached")
}

示例中的 errors、strings 和 indexSource 需要按实际项目补齐导入与实现。真正的回调应尽量短：耗时解析、网络请求或写库可以交给受控的工作队列，但要同步处理队列满、取消和关闭问题。

GlobWalk、Glob 和 FilepathGlob 怎么选

当目录不存在时，默认行为不等同于业务异常；需要遇到 I/O 问题就停止，可传入 doublestar.WithFailOnIOErrors()。如果只允许常规文件，可以考虑 WithFilesOnly()；不希望遍历符号链接时使用 WithNoFollow()，但要注意其对模式前缀中符号链接的边界。

使用 ** 模式前的检查清单

• Glob 模式不是正则表达式；递归匹配应写成独立路径段，例如 src/**/*.go。
• Glob 与 GlobWalk 默认使用 / 分隔符，Windows 输入应先统一路径表达。
• ** 可能读取大量目录；把根 FS 限定在业务目录，并用第一轮模式减少候选范围。
• 隐藏目录、符号链接和权限错误必须按业务要求显式决定，不能把默认忽略误当成安全策略。

GlobWalk 相关问题

GlobWalk 为什么比 Glob 更适合大目录处理？

它用回调交付匹配项，不必先构造完整结果切片，还能在目标出现或错误发生时提前结束；代价是业务需要自己管理处理状态。

回调返回 SkipDir 会跳过什么？

当当前路径是目录时，它阻止继续递归该目录；它不是全局取消信号。要结束整个遍历，应返回自定义错误并在外层识别。

为什么不用正则表达式直接匹配路径？

GlobWalk 的模式先负责缩小文件系统候选，复杂条件可在回调中二次过滤。这样既保留目录递归能力，也避免把正则语法误塞进 glob 模式。

把 os.DirFS、GlobWalk 和回调边界设计清楚，Doublestar 就能从“找出一批路径”变成“发现一个就安全处理一个”。真正上线前，重点不是继续堆叠通配符，而是限制遍历根、明确错误策略，并为主动停止和资源清理留下业务分支。