Go filepath.WalkDir 怎么跳过隐藏目录并继续遍历

在Go的文件遍历场景里用`filepath.WalkDir`的时候，想要跳过隐藏目录同时还能正常遍历其余非隐藏的目录文件，不需要多余的嵌套判断，直接在回调函数里做条件匹配后返回`filepath.SkipDir`就可以达到效果。

判断当前访问的条目是目录且名称符合隐藏目录规则后，直接返回`filepath.SkipDir`，就会让`WalkDir`直接跳过该目录下的所有子条目，继续执行遍历剩余路径的逻辑。

用 Go 扫描项目目录、备份目录或上传文件时，常常希望跳过 .git、.cache 这类隐藏目录，但仍然处理同级的普通文件。filepath.WalkDir 的关键不是提前过滤路径，而是在回调中判断当前 DirEntry：确认它是目录且名称以点号开头后，返回 fs.SkipDir。

最小可靠规则是：先处理非空 err，再判断 d.IsDir() 和 d.Name()；隐藏目录返回 fs.SkipDir，其他节点返回 nil。这样只跳过当前目录的内容，遍历会继续走后面的路径。

用 fs.SkipDir 跳过目录，普通文件继续处理

filepath.WalkDir 会把根节点以及每个文件、目录交给 fs.WalkDirFunc。回调中的 d 是 fs.DirEntry，因此可以先用 d.IsDir() 区分目录，再用 d.Name() 检查名称。只要两个条件同时成立，就返回 fs.SkipDir，不会进入这个目录的子树。

这里不要只写 strings.HasPrefix(path, ".")：完整路径可能以普通父目录开头，路径前缀并不等于当前节点名称。用 d.Name() 判断，规则更局部，也不受操作系统路径分隔符影响。

错误返回要和跳过动作分开处理

回调的 err 表示访问当前路径时出现了问题。根目录的初始访问失败时，d 可能为 nil；子目录读取失败时，回调可能带着该目录的 DirEntry 再次报告错误。所以正确顺序是先判断 err != nil，再使用 d。

默认建议返回原始错误，让调用方知道遍历不完整。如果业务明确允许某个不可读目录被忽略，也可以在确认路径属于可忽略范围后返回 fs.SkipDir；不要把所有错误都吞掉，否则“扫描完成”可能只是漏扫后的假象。

一个可复用的隐藏目录过滤函数

下面的实现把“是否隐藏目录”和“遇到错误怎么办”放在同一个回调里。示例只收集普通文件，目录本身不进入结果；如果需要统计目录，可在返回前增加自己的处理逻辑。

package main

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

func walkVisibleFiles(root string) ([]string, error) {
	var files []string
	err := filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
		if err != nil {
			// 根目录失败时 d 可能为 nil，先返回真实访问错误。
			return err
		}
		if d.IsDir() && strings.HasPrefix(d.Name(), ".") {
			// 只跳过当前隐藏目录，后续同级路径仍会继续遍历。
			return fs.SkipDir
		}
		if !d.IsDir() {
			// 目录过滤后只把普通文件交给业务逻辑。
			files = append(files, path)
		}
		return nil
	})
	if err != nil {
		// 调用方可以据此区分“部分结果”和“完整扫描”。
		return nil, fmt.Errorf("遍历 %q 失败: %w", root, err)
	}
	return files, nil
}

strings.HasPrefix 只是识别约定，不代表系统隐藏属性；例如名为 .env 的文件仍会进入文件分支。若项目把某些普通目录也命名为点号开头，它同样会被跳过，调用前应先确认这符合业务规则。

SkipDir、SkipAll 和符号链接怎么选

filepath.WalkDir 按词法顺序访问目录，并且不会跟随目录中的符号链接。这里的“继续遍历”指跳过当前隐藏目录后处理其他兄弟节点，不是递归进入符号链接目标。若你的需求是统一处理虚拟文件系统，应另看 io/fs.WalkDir，它使用斜杠路径。

相关问题

隐藏目录下的文件会被回调吗？

当回调对隐藏目录返回 fs.SkipDir 后，不会继续访问该目录的子项；同级文件和后续目录仍会被回调。

为什么不能直接对 d.Name 调用 strings.HasPrefix？

可以调用，但必须先确认 err == nil 且 d != nil。根目录访问失败时 d 可能为空，先访问它会触发 panic。

返回 fs.SkipDir 会让 WalkDir 返回错误吗？

对目录节点返回 fs.SkipDir 是正常的跳过信号，WalkDir 会把它当作成功处理；它和返回普通非空错误的语义不同。

实际接入时只需记住一条检查清单：错误先判、目录再判、名称最后判；隐藏目录返回 fs.SkipDir，真实访问错误原样返回。这样过滤规则清楚，调用方也能准确知道结果是否完整。