Go filepath.WalkDir 怎么在遇到符号链接时保持不跟随

用 Go 扫描目录时，filepath.WalkDir 已经默认“不跟随符号链接”。遇到指向目录的链接，它会把链接这个目录项交给回调，但不会进入链接目标；因此通常不需要额外写防循环逻辑。真正要做的是在回调里识别 os.ModeSymlink，决定记录、跳过还是显式解析目标。

为什么 WalkDir 遇到符号链接不会进去

filepath.WalkDir 从根路径开始访问每个目录项，包含根目录本身，并按词法顺序处理同一目录下的条目。它的设计边界很明确：不跟随符号链接。链接指向一个目录时，回调仍然会收到这个链接，但遍历器不会把目标目录当成当前目录继续打开。

这个默认值很适合备份、索引和代码扫描：目录树里可能存在回指上级目录的链接，如果自动跟随，就会重复扫描甚至形成循环。注意“访问了链接”和“进入了链接目标”是两件事。想保留链接名用于报告时，回调返回 nil 即可；想完全忽略链接时，识别后直接返回。

写一个只统计真实文件的目录扫描器

下面的小工具收集目录中的真实文件，并单独记录符号链接。错误先判断，避免 d 为空时继续调用方法；链接判断放在 IsDir 前面，语义更直观。

package main

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

func scan(root string) error {
    return filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
        if err != nil {
            // 当前目录项无法读取时返回错误，让调用方决定是否终止扫描。
            return fmt.Errorf("访问 %s 失败: %w", path, err)
        }
        if d.Type()&os.ModeSymlink != 0 {
            // 记录链接本身，但不调用自定义递归，也不把目标文件计入结果。
            fmt.Printf("符号链接: %s\n", path)
            return nil
        }
        if d.IsDir() {
            // 真实目录由 WalkDir 负责继续进入。
            return nil
        }
        fmt.Printf("真实文件: %s\n", path)
        return nil
    })
}

func main() {
    if err := scan("./workspace"); err != nil {
        // 顶层统一处理失败，避免静默得到不完整清单。
        fmt.Println(err)
        os.Exit(1)
    }
}

这里没有人为调用递归函数，所以链接不会改变遍历边界。DirEntry.Type() 只看目录项自身的类型位；当它包含 os.ModeSymlink 时，应把它当作链接处理。至于链接指向什么，属于另一个问题。

需要查看链接目标时，别把 Info 和 Stat 混用

如果业务只关心“这个路径是不是链接”，保留 DirEntry 判断就够了。若要读取目标的元数据，可以显式调用 os.Stat(path)，它会跟随链接；若只想把路径解析成最终位置，则使用 filepath.EvalSymlinks(path)。这两个调用都不是 WalkDir 的默认行为。

也不要为了“确认是不是目录”就对所有路径调用 os.Stat：那会把本来安全的“不跟随”策略改成了局部跟随。若确实需要跟随目录链接，最好把它作为独立策略实现，并增加已访问目标集合、循环检测和权限错误处理。

运行前后的检查清单

准备一个普通目录、一个普通文件、一个指向文件的链接和一个指向目录的链接。验收时应看到两个链接自身的记录，但看不到链接目标目录下被重复打印的文件。若目录权限不足，回调会收到错误；是终止扫描还是记录后继续，应根据索引任务的重要性选择。

跨平台时还要注意：filepath 使用当前操作系统的路径分隔符，日志不要手工拼接斜杠。需要生成 URL 或归一化展示路径时，再使用 filepath.ToSlash，不要把文件系统路径和 URL 路径混为一谈。

常见问题

WalkDir 会不会访问符号链接指向的目录？

不会。它会回调链接这个目录项，但默认不进入链接目标。

为什么不能只用 d.IsDir() 判断？

因为题目关心的是链接身份；先判断 ModeSymlink 才不会把“链接目标像目录”误读成“应该递归”。

什么时候需要 EvalSymlinks？

只有业务必须得到解析后的目标路径时才调用，并为断链、权限和循环目标准备错误处理。