如何在Golang中检测文件或目录是否存在_使用os Stat判断存在性

推荐用 os.Stat 配合 errors.Is(err, os.ErrNotExist) 判断路径是否存在:成功获取 FileInfo 表示存在;错误为 os.ErrNotExist 表示不存在;其他错误需单独处理。

在 Go 语言中,检测文件或目录是否存在,最常用且推荐的方式是调用 os.Stat 并检查返回的错误是否为 os.ErrNotExist。这不是“判断布尔值”,而是通过错误类型来推断存在性——这是 Go 的惯用做法。

使用 os.Stat 检查路径是否存在

os.Stat 会尝试获取指定路径的文件信息(os.FileInfo)。如果路径不存在,它返回一个非 nil 错误,且该错误可被 errors.Is(err, os.ErrNotExist) 准确识别。

  • 成功获取 FileInfo → 路径存在(无论文件还是目录)
  • 错误为 os.ErrNotExist → 路径不存在
  • 其他错误(如权限不足、设备不可达等)→ 需按业务逻辑处理,不能简单当作“不存在”

区分文件和目录存在性

os.Stat 本身不直接告诉你“是文件还是目录”,但拿到 os.FileInfo 后,可通过 IsDir() 方法判断:

  • info.IsDir() == true → 是目录
  • info.IsDir() == false && err == nil → 是普通文件(或符号链接、设备文件等,需进一步用 info.Mode().IsRegular() 判断是否为常规文件)

注意:符号链接若指向不存在的目标,os.Stat 会跟随并报 os.ErrNotExist;如需检查链接本身是否存在,应使用 os.Lstat

推荐写法:简洁、安全、符合 Go 风格

避免使用 os.IsNotExist(err)(已弃用),改用 errors.Is(err, os.ErrNotExist)(Go 1.13+):

func exists(path string) (bool, error) {
    _, err := os.Stat(path)
    if err == nil {
        return true, nil
    }
    if errors.Is(err, os.ErrNotExist) {
        return false, nil
    }
    return false, err // 其他错误,如 permission denied
}

若只需判断存在性而不关心具体错误类型,也可直接:

if _, err := os.Stat(path); errors.Is(err, os.ErrNotExist) {
    // 不存在
} else if err != nil {
    // 其他错误
} else {
    // 存在
}

为什么不推荐 os.IsExist / os.IsNotExist?

os.IsNotExist 是兼容函数,底层仍调用 errors.Is(err, os.ErrNotExist),但语义易混淆(比如名字像“判断是否已存在”)。而 os.ErrNotExist 是导出变量,配合 errors.Is 更清晰、更符合错误处理规范。Go 官方文档和标准库示例均已采用此方式。