
本文详解 Go 中 ioutil.ReadDir、filepath.Glob 和 os.File.Readdirnames 等目录操作常见 panic 的根本原因——错误检查逻辑颠倒导致对 nil 切片遍历,并提供符合 Go 习惯的健壮写法与实用示例。
本文详解 go 中 `ioutil.readdir`、`filepath.glob` 和 `os.file.readdirnames` 等目录操作常见 panic 的根本原因——错误检查逻辑颠倒导致对 nil 切片遍历,并提供符合 go 习惯的健壮写法与实用示例。
在 Go 中读取目录内容时,初学者常因混淆错误处理逻辑而触发 panic: runtime error: invalid memory address or nil pointer dereference。问题核心并非 API 本身失效,而是错误未被及时拦截,却试图遍历一个为 nil 的切片。
以 ioutil.ReadDir(folder) 为例:当调用失败(如路径不存在、权限不足),它返回 nil, err;此时若错误检查写成 if err != nil { for _, info := range infos { ... } },就会在 infos 为 nil 的情况下执行循环,直接 panic。同理,filepath.Glob 和 file.Readdirnames 也遵循这一契约:出错时结果值为零值(nil 切片或空字符串等),绝不可直接使用。
✅ 正确做法是:先检查 err,仅当 err == nil 时才安全使用返回值。以下是修复后的标准写法:
func readDir(folder string) error {
infos, err := ioutil.ReadDir(folder)
if err != nil { // ✅ 错误优先检查:失败则立即返回或处理
return fmt.Errorf("failed to read directory %q: %w", folder, err)
}
for _, info := range infos { // ✅ 此时 infos 必然非 nil 且有效
fmt.Println(info.Name(), info.IsDir(), info.Size())
}
return nil
}
同样修正 filepath.Glob 的用法:
func glob(pattern string) error {
matches, err := filepath.Glob(pattern)
if err != nil { // ✅ 不是 "if err != nil { for... }"
return fmt.Errorf("glob pattern %q failed: %w", pattern, err)
}
for _, path := range matches {
fmt.Println(path)
}
return nil
}
以及基于 os.Open 的手动读取方式:
func listByOpen(folder string) error {
file, err := os.Open(folder)
if err != nil {
return fmt.Errorf("failed to open folder %q: %w", folder, err)
}
defer file.Close() // ✅ defer 放在错误检查之后,确保 file 非 nil
infos, err := file.Readdir(0) // 或 Readdirnames(0)
if err != nil {
return fmt.Errorf("failed to read dir contents: %w", err)
}
for _, info := range infos {
fmt.Println(info.Name())
}
return nil
}
⚠️ 注意事项:
-
ioutil.ReadDir在 Go 1.16+ 已被弃用,推荐改用os.ReadDir(返回[]fs.DirEntry,性能更优且不加载完整FileInfo); - 所有 I/O 操作都应显式处理错误,Go 不允许忽略返回的 error;
-
defer file.Close()必须在确认file != nil后调用,否则defer会捕获nil值并 panic; - 日志中优先使用
log.Fatal(err)而非log.Fatal(err.Error()),前者能保留错误链(Go 1.13+)。
总结:Go 的错误处理是显式且严格的。牢记 “check error first, then use result” 这一铁律,就能彻底规避此类 panic,写出健壮、可维护的文件系统操作代码。










