Go语言如何遍历目录文件_Go语言filepath.Walk教程【实战】

filepath.Walk默认不跟随符号链接且不进入其指向目录，需手动实现递归逻辑并用inode去重防循环；返回普通error仅跳过当前路径，SkipDir跳过子项，SkipAll终止全部遍历；Windows路径分隔符混乱应统一Clean+ToSlash处理；大目录卡顿OOM应改用WalkDir流式遍历。filepath.Walk 会跳过符号链接，不进子目录怎么办默认情况下 filepath.Walk 不会跟随符号链接（symlink），遇到它就直接跳过，也不会递归进入 symlink 指向的目录。这不是 bug，是设计行为——Go 认为“遍历路径”应以显式路径为准，避免循环引用或权限越界。如果真需要跟随符号链接并递归访问目标目录，得自己实现 walk 逻辑，用 os.ReadDir + 递归调用，配合 os.Stat 和 os.Lstat 区分链接本身和目标：func walkWithSymlinks(root string, fn filepath.WalkFunc) error {return walkSymlinkAware(root, fn, map[string]bool{})}func walkSymlinkAware(path string, fn filepath.WalkFunc, seen map[string]bool) error {info, err := os.Lstat(path)if err != nil {return fn(path, nil, err)}if err := fn(path, info, nil); err != nil {return err}if !info.IsDir() {return nil}// 防止循环：记录已访问的 inode+dev（跨文件系统需谨慎）dev, ino := info.Sys().(*syscall.Stat_t).Dev, info.Sys().(*syscall.Stat_t).Inokey := fmt.Sprintf("%d:%d", dev, ino)if seen[key] {return nil}seen[key] = trueentries, err := os.ReadDir(path)if err != nil {return fn(path, info, err)}for _, e := range entries {child := filepath.Join(path, e.Name())if e.Type()&os.ModeSymlink != 0 {target, _ := os.Readlink(child)if !filepath.IsAbs(target) {target = filepath.Join(filepath.Dir(child), target)}// 跟随链接后继续遍历if err := walkSymlinkAware(target, fn, seen); err != nil {return err}continue}if err := walkSymlinkAware(child, fn, seen); err != nil {return err}}return nil}用 os.Lstat 获取链接本身信息，os.Stat 才会解析目标必须做 inode/设备号去重，否则软链 A→B→A 会无限递归filepath.Walk 内置不支持此模式，强行 patch WalkFunc 无法改变底层遍历逻辑filepath.Walk 返回 error 后是否继续遍历会继续。只要 WalkFunc 返回非 nil error，filepath.Walk 会把它当作该路径的处理结果，但不会中断整个遍历——除非返回的是 filepath.SkipDir 或 filepath.SkipAll 这两个预定义哨兵值。常见误判是看到某个目录报错（比如 permission denied），以为后续路径全丢了，其实只是那个目录下的子项被跳过，兄弟目录照常走。立即学习“go语言免费学习笔记（深入）”； Trenz AI驱动的社交电商营销平台，专为TikTok Shop设计