
本文详解 Go 中 ioutil.ReadDir、filepath.Glob 和 os.File.Readdirnames 等目录操作函数常见的逻辑错误——将 err != nil 与 err == nil 的分支处理颠倒,导致遍历未初始化的 nil 切片而触发 panic。
本文详解 go 中 `ioutil.readdir`、`filepath.glob` 和 `os.file.readdirnames` 等目录操作函数常见的逻辑错误——将 `err != nil` 与 `err == nil` 的分支处理颠倒,导致遍历未初始化的 `nil` 切片而触发 panic。
在 Go 中读取目录内容时(如使用 ioutil.ReadDir、filepath.Glob 或 *os.File.Readdirnames),一个高频且隐蔽的错误是错误检查逻辑反转。正如提问者所遇:程序在调用后立即 panic 报 invalid memory address or nil pointer dereference,根源并非 API 失效或系统权限问题,而是开发者误将错误路径当作成功路径执行了切片遍历。
以 ioutil.ReadDir(folder) 为例:当路径无效、无访问权限或 folder 为空字符串时,该函数返回 (nil, err) —— 即 infos 为 nil,err 非空。此时若错误地写成:
if err != nil {
// ❌ 错误:此处 err != nil 表示失败,infos 必为 nil!
for _, info := range infos { // panic: range over nil slice
fmt.Println(info)
}
} else {
log.Fatal(err.Error()) // ❌ 更错:成功时 err == nil,.Error() 会 panic
}这段代码在出错时试图遍历 nil 的 infos,直接触发运行时 panic;而在成功时又对 nil 错误调用 .Error(),同样崩溃。这是典型的“条件分支与语义背离”。
✅ 正确做法是:仅在 err == nil 时才安全使用返回值。标准模式如下:
func readDir(folder string) error {
infos, err := ioutil.ReadDir(folder)
if err != nil { // ✅ err != nil → 操作失败,立即返回/处理错误
return err
}
// ✅ 此时 infos 已确定非 nil,可安全遍历
for _, info := range infos {
fmt.Println(info.Name()) // 推荐显式调用方法,提高可读性
}
return nil
}同理修正其他函数:
-
filepath.Glob:func glob(pattern string) error { matches, err := filepath.Glob(pattern) if err != nil { return err // 不要在此处 range matches(可能为 nil) } for _, path := range matches { fmt.Println(path) } return nil } -
*os.File.Readdirnames(需确保file非 nil):func listDirWithOpen(folder string) error { file, err := os.Open(folder) if err != nil { return err } defer file.Close() // ✅ defer 必须在 err 检查之后,避免 panic 时 file 为 nil names, err := file.Readdirnames(0) if err != nil { return err } for _, name := range names { fmt.Println(name) } return nil }
⚠️ 关键注意事项:
-
ioutil.ReadDir在 Go 1.16+ 已被弃用,推荐改用os.ReadDir(返回[]fs.DirEntry,更轻量且支持fs.Stat延迟获取); - 所有
defer语句必须放在资源成功获取之后(如os.Open成功后才defer file.Close()),否则defer nil.Close()会 panic; - 不要假设
folder变量已初始化——空字符串、相对路径错误或权限不足均会导致err != nil; - 日志输出优先使用
log.Printf或结构化日志库,避免log.Fatal阻断调试流程。
总结:Go 的错误处理是显式且严格的。牢记 “有错即止,无错再用” 原则——任何 I/O 操作后,第一件事永远是检查 err;只有 err == nil 时,才能信任并使用其返回的数据。这一习惯不仅能避免 nil panic,更是构建健壮 Go 程序的基石。

















