如何使用Golang检测文件是否存在_Golang os Stat文件存在判断示例

不可靠。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.Lstatos.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.EIOsyscall.ENOTCONN,这些都不能当作「不存在」处理。

真正健壮的逻辑往往要结合业务场景:比如启动服务前检查配置文件,应明确报错「config not found or unreadable」并退出;而热加载配置时,则需区分「暂时不可读」和「永久不存在」,后者才触发默认值回退。