推荐用 os.Stat + os.IsNotExist 判断文件是否存在:os.Stat 成功表示存在且可读元数据;err != nil 且 os.IsNotExist(err) 表示确实不存在;否则为存在但访问失败。

用 os.Stat + os.IsNotExist 是唯一推荐方式
Go 没有 os.Exists,旧版已弃用;直接看 err != nil 就说“文件不存在”是错的——它可能是权限不足、NFS 超时、坏符号链接,甚至 Windows 上的 ACL 拒绝。真正能确认「不存在」的,只有 os.IsNotExist(err) 这个判断。
-
os.Stat("config.yaml")成功(err == nil)→ 路径存在且可读取元信息 -
err != nil && os.IsNotExist(err)→ 确实不存在(如 ENOENT / ERROR_FILE_NOT_FOUND) -
err != nil && !os.IsNotExist(err)→ 存在但访问失败,比如permission denied或broken symlink
别用 os.Open 替代 os.Stat 做存在性检查
os.Open 会真实打开文件、分配 fd,哪怕你立刻 Close(),也多一次系统调用、多一次资源管理风险。而 os.Stat 只读元数据,轻量、语义清晰、无副作用。
- 高频轮询或并发检查时,
os.Stat的 syscall 开销远小于os.Open - 忘记
Close()会导致 fd 泄露,尤其在容器或长期运行服务中隐患明显 - 如果后续真要读文件,可以复用
os.Stat返回的os.FileInfo判断类型/大小后再开,避免重复调用
符号链接要用 os.Lstat,不是 os.Stat
os.Stat 默认跟随符号链接,检查的是目标是否存在;如果你要确认「链接文件本身在磁盘上有没有」,比如部署脚本里检查软链是否被误删,就得换 os.Lstat。
-
os.Stat("/etc/resolv.conf")→ 检查的是它指向的真实文件存不存在 -
os.Lstat("/etc/resolv.conf")→ 检查的是/etc/resolv.conf这个路径本身是不是一个存在的符号链接(哪怕目标已删) - 注意:
os.Lstat对普通文件/目录行为和os.Stat一致,只是不自动解引用
并发或高频场景下,os.Stat 不是原子操作
文件状态可能在 os.Stat 返回“存在”后瞬间被删除、重命名或 chmod,所以「存在」只是瞬时快照。不要写成“先 Stat 再 Open”,而应把打开逻辑包进错误重试或统一处理流里。
立即学习“go语言免费学习笔记(深入)”;
- 热加载配置时,建议直接
os.Open并捕获os.IsNotExist,而不是两步走 - 批量检查多个文件,优先用
os.ReadDir(Go 1.16+)一次读取目录项,比反复Stat更高效,尤其在 NFS 或挂载卷上 - 缓存
os.Stat结果需谨慎——除非你明确知道路径不会变更,否则容易引入竞态
最常被忽略的一点:即使 os.Stat 说存在,os.OpenFile(..., os.O_WRONLY, 0) 仍可能失败——因为权限可能刚被改掉,或者父目录被 umount。存在性检查永远只是起点,不是保证。










