推荐用 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语言免费学习笔记(深入)”;
推荐写法:简洁、安全、符合 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 官方文档和标准库示例均已采用此方式。










