Golang如何判断文件是否存在

P粉602998670 2026-01-05 00:00:00 次阅读

最可靠方式是用os.Stat并配合os.IsNotExist(err)判断文件是否存在；直接err!=nil或错误字符串比较均不可靠，且需注意权限不足时os.IsNotExist返回false。

用 `os.Stat` 判断文件是否存在最可靠

Go 没有单独的 os.Exists 函数（旧版曾有，但已弃用），正确做法是调用 os.Stat 并检查错误类型。直接判断 err == nil 只能说明路径可访问，而 os.IsNotExist(err) 才能明确确认“不存在”。

os.Stat 会尝试获取文件元信息，无论路径是文件、目录还是符号链接，只要存在且可读，就返回 nil 错误
如果返回非 nil 错误，必须用 os.IsNotExist(err) 判断是否真为“不存在”，不能直接比对错误字符串或用 err != nil 简单取反
注意：os.IsNotExist 对权限不足（permission denied）也返回 false，此时错误不是“不存在”，而是“不可访问”

`os.Stat` 的典型用法和常见误判

下面这段代码常被复制，但它隐含陷阱：

_, err := os.Stat("/path/to/file")
if err != nil {
    // ❌ 错误：这里 err 可能是 permission denied、no such device 等，不一定是文件不存在
    fmt.Println("文件不存在")
}

正确写法必须显式检查错误类型：

_, err := os.Stat("/path/to/file")
if err != nil {
    if os.IsNotExist(err) {
        fmt.Println("文件确实不存在")
    } else {
        fmt.Printf("其他错误：%v", err)
    }
    return
}
fmt.Println("文件存在")

想同时区分文件和目录？继续看 `os.FileInfo`

os.Stat 返回的 os.FileInfo 可用于进一步判断类型：

立即学习“go语言免费学习笔记（深入）”；

用 fi.IsDir() 区分是目录还是普通文件
用 fi.Mode()&os.ModeSymlink != 0 检查是否为符号链接
注意：os.Stat 对符号链接会自动解引用；如需获取链接本身信息，改用 os.Lstat

fi, err := os.Stat("/path/to/file")
if err != nil {
    if os.IsNotExist(err) {
        // 不存在
    }
    return
}
if fi.IsDir() {
    fmt.Println("这是个目录")
} else {
    fmt.Println("这是个文件")
}