go 1.16 及以上可以用 filepath.walkdir() 递归遍历目录,在回调发现需要忽略的子目录时返回 fs.skipdir。先检查回调的 err,再访问 direntry,避免读取失败时解引用空值。只想读当前一层目录时则用 os.readdir,不需要递归遍历。

构建测试目录并跳过 vendor 和 .git 子目录
保存为 main.go 后执行 go run main.go。程序只在新建临时目录中创建测试树,完成后清理;collectGo 返回相对路径,并且只收集普通 .go 文件。忽略规则按目录名匹配,根目录本身不参与忽略。
package main
import (
"fmt"
"io/fs"
"os"
"path/filepath"
)
func collectGo(root string) ([]string, error) {
var files []string
err := filepath.WalkDir(root, func(path string, entry fs.DirEntry, walkErr error) error {
if walkErr != nil {
return walkErr
}
if entry.IsDir() {
if path != root && (entry.Name() == "vendor" || entry.Name() == ".git") {
return fs.SkipDir
}
return nil
}
if !entry.Type().IsRegular() || filepath.Ext(entry.Name()) != ".go" {
return nil
}
relative, err := filepath.Rel(root, path)
if err != nil {
return err
}
files = append(files, filepath.ToSlash(relative))
return nil
})
return files, err
}
func main() {
root, err := os.MkdirTemp("", "walk-demo-*")
if err != nil {
panic(err)
}
defer os.RemoveAll(root)
for _, name := range []string{"a.go", "src/b.go", "src/vendor/c.go", ".git/d.go", "readme.txt"} {
path := filepath.Join(root, filepath.FromSlash(name))
if err := os.MkdirAll(filepath.Dir(path), 0755); err != nil {
panic(err)
}
if err := os.WriteFile(path, []byte("example"), 0644); err != nil {
panic(err)
}
}
files, err := collectGo(root)
if err != nil {
panic(err)
}
fmt.Println(files) // [a.go src/b.go]
}
SkipDir 只在确认当前项是目录时返回。若对普通文件返回 SkipDir,可能跳过它所在目录的后续项,不等于“只略过这个文件”。WalkDir 默认也不会递归跟随符号链接,此例将符号链接排除在普通文件结果之外。

用 ReadDir 核对当前目录的一层内容
如果只需要列出第一层,可保存下面的独立程序,在一个已知测试目录执行。ReadDir 不会递归进入子目录,返回结果按名称排序。需要递归并忽略整棵子树时,再使用前一节的 WalkDir。
package main
import (
"fmt"
"os"
)
func main() {
entries, err := os.ReadDir(".")
if err != nil {
panic(err)
}
for _, entry := range entries {
fmt.Printf("%s directory=%v\n", entry.Name(), entry.IsDir())
}
}
IsDir 表示是否为目录,并不等于是否为普通文件。若需要读取大小,可调用 entry.Info(),并检查其 error 后再使用 Size;遍历期间文件可能被移除,不能忽略这种失败。
验证路径不存在时会返回错误而不是静默漏文件
在第一个 main 中创建 root 后、创建文件前,加入下列代码。测试路径尚不存在,因此应返回错误。collectGo 的结果如果伴随错误,只能视为未完成的遍历,不应直接作为“全部文件”继续处理。
missing := filepath.Join(root, "missing")
_, err = collectGo(missing)
if err == nil {
panic("不存在的目录应返回错误")
}
fmt.Println("不存在路径已识别:", err)
本例遇到访问错误立即返回,终止遍历。若业务允许跳过无权限目录,可以制定另一套记录与继续策略,但必须向调用方说明结果可能不完整。不要在 err 非空时继续调用 entry.IsDir。










