不可靠。os.Stat 直接判错易将权限不足、坏链接等误作“不存在”,须用 errors.Is(err, os.ErrNotExist) 精确识别;更优方案是 os.Lstat(不跟随链接)或 os.ReadDir(批量检查)。

用 os.Stat 判断文件是否存在是否可靠?
不可靠。直接调用 os.Stat 并检查错误是否为 os.ErrNotExist 是常见做法,但它会把「权限不足」「路径是坏符号链接」「设备不可达」等非“不存在”问题也误判为不存在。真正想确认的是「路径存在且可访问」,而不是「恰好不是因为不存在而失败」。
os.Stat + 错误类型判断的正确写法
必须用 errors.Is(Go 1.13+)或 os.IsNotExist(兼容旧版)来识别 os.ErrNotExist,不能用 == 或 strings.Contains(err.Error(), "no such") —— 后者在不同系统、不同语言环境下会失效。
fi, err := os.Stat("/path/to/file")
if err != nil {
if errors.Is(err, os.ErrNotExist) {
// 文件确实不存在
} else {
// 其他错误:可能是 permission denied、io timeout、broken symlink 等
log.Printf("stat failed: %v", err)
return
}
} else {
// 文件存在,且 fi 包含类型、大小、modtime 等信息
}
更轻量、更专注的替代方案:os.Lstat 和 os.ReadDir
如果只关心「路径是否存在」,不关心是否可读/可执行,os.Lstat 更合适——它不跟随符号链接,避免因目标不可达导致误报;若只需检查目录下某文件名是否存在(比如配置文件、插件),用 os.ReadDir 配合遍历比反复 Stat 更高效(尤其在 NFS 或慢存储上)。
-
os.Lstat:适合检查路径本身是否存在,包括符号链接自身 -
os.ReadDir(dir):适合批量检查子项,返回[]fs.DirEntry,不加载完整FileInfo - 避免对同一路径高频调用
os.Stat,考虑加缓存或用filepath.WalkDir批量处理
注意跨平台行为差异
Windows 下路径大小写不敏感,但 os.Stat 仍可能因 ACL 或重解析点返回非 os.ErrNotExist 错误;Linux/macOS 下,挂载点突然卸载、NFS 超时都可能导致 syscall.EIO 或 syscall.ENOTCONN,这些都不能当作「不存在」处理。
立即学习“go语言免费学习笔记(深入)”;
真正健壮的逻辑往往要结合业务场景:比如启动服务前检查配置文件,应明确报错「config not found or unreadable」并退出;而热加载配置时,则需区分「暂时不可读」和「永久不存在」,后者才触发默认值回退。










