推荐用 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 或 br

  

  oken 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”，而应把打开逻辑包进错误重试或统一处理流里。

• 热加载配置时，建议直接 os.Open 并捕获 os.IsNotExist，而不是两步走
• 批量检查多个文件，优先用 os.ReadDir（Go 1.16+）一次读取目录项，比反复 Stat 更高效，尤其在 NFS 或挂载卷上
• 缓存 os.Stat 结果需谨慎——除非你明确知道路径不会变更，否则容易引入竞态

最常被忽略的一点：即使 os.Stat 说存在，os.OpenFile(..., os.O_WRONLY, 0) 仍可能失败——因为权限可能刚被改掉，或者父目录被 umount。存在性检查永远只是起点，不是保证。