os.Stat 返回 os.ErrNotExist 仅表示文件不存在，但其他错误（如权限不足、路径非法等）也可能导致失败；应使用 errors.Is(err, os.ErrNotExist) 判断，而非 == 或字符串匹配。
os.Stat 返回 os.ErrNotExist 就代表文件不存在？
不完全是。很多开发者看到 os.Stat 报错就直接认为“文件不存在”，但其实它可能因权限不足、路径中有非法符号、挂载点失效等返回其他错误，os.ErrNotExist 只是其中一种。
正确做法是用 errors.Is 显式判断错误类型，而不是用 == 比对指针或字符串匹配错误信息：
fi, err := os.Stat("/path/to/file")
if err != nil {
if errors.Is(err, os.ErrNotExist) {
// 真正的“不存在”
} else {
// 其他错误：可能是 permission denied、no such device 等
}
return
}
// 文件存在且可访问（至少 stat 成功）
-
os.Stat会触发一次系统调用，哪怕只为了判断存在性，也带权限检查开销 - 如果只是想快速判断“路径是否存在”，
os.Stat不是最轻量方案（见下一条） - Windows 下某些重解析点（如符号链接、OneDrive 虚拟文件）可能导致
os.Stat行为异常，返回syscall.ENOENT或syscall.EACCES
比 os.Stat 更轻量的文件存在性检查：os.Lstat 和 os.OpenFile 的组合
如果目标只是确认路径是否在文件系统中存在（不管是否可读/是否是目录），os.Lstat 是更稳妥的选择——它不跟随符号链接，避免了链接断裂导致的误判；而 os.OpenFile(path, os.O_RDONLY, 0) 加 defer f.Close() 则适合后续要读写的场景，顺便完成存在性验证。
-
os.Lstat在软链接指向无效路径时仍能返回元信息（即链接本身存在），而os.Stat会失败 -
os.OpenFile(..., os.O_RDONLY, 0)在文件存在但无读权限时也会报错，此时不能反推“不存在”，需结合errors.Is(err, os.ErrNotExist)再判断 - 注意：
os.OpenFile打开后必须Close()，否则小文件多时可能耗尽文件描述符
为什么不能用 os.IsNotExist(err) 直接判断？
os.IsNotExist 是个过时的兼容函数，Go 1.13+ 推荐用 errors.Is(err, os.ErrNotExist)。前者内部仍用 == 比较错误值，在自定义错误包装（比如用 xerrors 或 fmt.Errorf("wrap: %w", err)）时会失效。
立即学习“go语言免费学习笔记（深入）”；
- 旧写法：
os.IsNotExist(err)—— 在 error wrap 场景下大概率返回 false - 新写法：
errors.Is(err, os.ErrNotExist)—— 正确穿透 wrapped error - 如果你的项目还依赖
golang.org/x/xerrors，确保已升级到支持 Go 1.13+ error wrapping 的版本
真实项目里常被忽略的边界：空字符串、相对路径、root 权限
os.Stat("") 会 panic，os.Stat("./") 和 os.Stat(".\") 在 Windows 下行为不一致，而 os.Stat("/proc/self/fd/999999") 这类伪路径在 Linux 下可能返回 syscall.ENXIO 而非 os.ErrNotExist。
- 所有输入路径建议先做
filepath.Clean规范化，再检查是否为空 - 跨平台代码中，避免硬写
"\"或"/"，统一用filepath.Join - 在容器或 chroot 环境中，
/proc、/sys下的路径可能看似存在但无法 stat，这类情况应归为“不可访问”而非“不存在”
真正难的不是写对一行 os.Stat，而是想清楚你到底要确认什么：是路径字面量存在？是文件可打开？还是有读权限？每个问题对应不同的检查方式和错误处理逻辑。
