当前位置：首页 > 文章列表 > Golang > Go教程 > Go filepath.WalkDir 遇到权限错误时如何继续其他目录

Go filepath.WalkDir 遇到权限错误时如何继续其他目录

来源：17golang原创 2026-09-11 13:56:02 0浏览收藏

用 filepath.WalkDir 扫描上传目录、备份目录或代码仓库时，某个子目录没有读取权限，并不代表其他目录也无法处理。关键在于：先处理回调传入的 err，确认它是否属于权限错误，再决定返回 filepath.SkipDir、nil，还是把错误继续返回。目录错误跳过子树，文件错误只放过当前文件，非预期错误则保留中止信号。

要点速览

回调中的 err 非空时，不能先调用 d.IsDir()；d 可能为空。
确认是权限类目录错误后返回 filepath.SkipDir，遍历会继续处理同级可读目录。
未知错误不要静默吞掉，记录跳过路径，并通过最终返回值告诉调用方结果不完整。

先判断 WalkDir 回调拿到的错误属于哪一层

WalkDir 会把根目录和遍历到的每个文件、目录交给 fs.WalkDirFunc。当访问路径失败时，回调收到的 err 描述这次失败；如果连路径自身的状态都取不到，d 可能是 nil。因此错误分支必须放在所有 d.IsDir()、d.Name() 之前。

浅色工程蓝图展示根目录、WalkDir 回调、DirEntry、错误和 SkipDir 的边界关系 — 图1：查看 WalkDir 回调中路径、DirEntry 与错误决策的边界，避免先解引用空的 DirEntry。

还要区分“遍历器无法进入目录”和“某个文件无法读取”。前者适合跳过当前子树，后者通常只应记录并继续兄弟文件。不要因为一个文件报权限错误，就让整个父目录剩余内容都被跳过。

用 SkipDir 跳过不可读子树，遍历继续

下面的处理器只对权限类目录错误返回 filepath.SkipDir。遇到权限错误但 d 不是目录时返回 nil，表示放过当前文件；其他错误原样返回，让上层知道扫描没有完整结束。

package main

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

func visitTree(root string) error {
    return filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
        if err != nil {
            // 访问失败时 d 可能为空，先记录路径，不能直接调用 d.IsDir。
            fmt.Printf("skip %s: %v\n", path, err)

            if d != nil && d.IsDir() && errors.Is(err, fs.ErrPermission) {
                // 目录不可读：跳过整棵子树，但保留同级目录的遍历。
                return filepath.SkipDir
            }
            if errors.Is(err, fs.ErrPermission) {
                // 文件不可读：只忽略当前文件，不扩大跳过范围。
                return nil
            }
            // 非权限错误可能代表更严重的异常，交给调用方处理。
            return err
        }

        if d.IsDir() && d.Name() == ".cache" {
            // 明确不需要扫描的目录也只影响当前子树。
            return filepath.SkipDir
        }
        return nil
    })
}