
本文详解 Go 中读取目录时常见的 invalid memory address or nil pointer dereference 错误根源,指出错误的错误处理逻辑(如在 err != nil 时遍历未初始化的 infos),并提供安全、规范、可复用的目录遍历实现方案。
本文详解 go 中读取目录时常见的 `invalid memory address or nil pointer dereference` 错误根源,指出错误的错误处理逻辑(如在 `err != nil` 时遍历未初始化的 `infos`),并提供安全、规范、可复用的目录遍历实现方案。
在 Go 中读取目录内容是文件操作的基础需求,但初学者常因错误的错误处理逻辑触发运行时 panic——尤其是 panic: runtime error: invalid memory address or nil pointer dereference。问题核心并非 API 本身不可用,而是混淆了错误发生时变量的有效性:当 ioutil.ReadDir、filepath.Glob 或 os.File.Readdirnames 返回非 nil 错误时,其第一个返回值(如 infos)保证为 nil,此时对 infos 进行 range 遍历将导致空指针解引用。
以原代码为例:
func readDir() {
infos, err := ioutil.ReadDir(folder)
if err != nil {
for _, info := range infos { // ❌ panic!infos == nil
fmt.Println(info)
}
} else {
log.Fatal(err.Error()) // ❌ 逻辑颠倒:成功时反而报错
}
}此处存在两处关键错误:
-
错误分支误用返回值:
err != nil时infos为nil,直接range infos必 panic; -
成功/失败逻辑倒置:
else块中却调用log.Fatal(err.Error()),而此时err == nil,err.Error()将 panic(nil 指针调用方法)。
✅ 正确做法是:先检查错误,仅在无错时才使用结果值。以下是修正后的标准写法:
import (
"fmt"
"io/ioutil"
"log"
"os"
)
func readDir(folder string) error {
infos, err := ioutil.ReadDir(folder)
if err != nil { // ✅ 先检查错误
return err // ✅ 直接返回,不访问 infos
}
// ✅ 此时 infos 非 nil,可安全遍历
for _, info := range infos {
fmt.Println(info.Name()) // 输出文件/目录名
}
return nil
}更进一步,推荐使用 Go 1.16+ 引入的 os.ReadDir(替代已弃用的 ioutil.ReadDir),它返回 []fs.DirEntry,性能更优且支持跳过符号链接等控制:
func readDirModern(folder string) error {
entries, err := os.ReadDir(folder) // 返回 []fs.DirEntry,非 []os.FileInfo
if err != nil {
return err
}
for _, entry := range entries {
fmt.Printf("Name: %s, IsDir: %t\n", entry.Name(), entry.IsDir())
// 如需完整 FileInfo,可调用 entry.Info()(可能触发额外系统调用)
}
return nil
}⚠️ 注意事项:
-
永远不要在
err != nil分支中使用其他返回值(如infos,files,matches),Go 标准库约定:错误非 nil 时其余返回值无效; -
filepath.Glob同理,正确用法是matches, err := filepath.Glob("*.go"); if err != nil { return err }; for _, m := range matches { ... }; -
os.Open后务必检查err,再调用file.Name()等方法,否则file可能为nil; -
defer file.Close()应置于err检查之后,避免对nil文件句柄调用Close()。
总结:Go 的错误处理是显式且严格的。掌握“先验错,后用值”这一原则,即可彻底规避此类 panic。结合 os.ReadDir 等现代 API,既能写出健壮代码,又能获得更好性能与可维护性。

















