用 os.Stat 检查文件是否存在是最稳妥的方式,需用 os.IsNotExist(err) 判断错误类型,而非 err == os.ErrNotExist 或 os.Open;os.Stat 不打开文件、轻量安全,且默认解引用符号链接,检查链接本身存在性应使用 os.Lstat。

用 os.Stat 检查文件是否存在是最稳妥的方式
Go 没有直接的 os.Exists(旧版曾有但已弃用),最常用且推荐的做法是调用 os.Stat 并检查错误类型。它不仅能判断存在性,还能顺便获取文件元信息。
关键点在于:不能只看错误是否为 nil,而要判断错误是否是 os.ErrNotExist —— 因为其他错误(如权限不足、路径过长、设备不可用)也会返回非 nil 错误,但它们不表示“不存在”。
fi, err := os.Stat("/path/to/file")
if err != nil {
if os.IsNotExist(err) {
// 文件或目录确实不存在
} else {
// 其他系统错误,比如 permission denied
}
return
}
// err == nil,说明存在,且 fi 是 *os.FileInfo
os.IsNotExist 比直接比对 err == os.ErrNotExist 更安全
os.IsNotExist 是一个类型检查函数,能正确识别底层由不同系统调用(如 open、stat、lstat)返回的“不存在”错误,包括包装过的错误(例如用 fmt.Errorf("failed: %w", err) 包装后)。而直接比较 err == os.ErrNotExist 在大多数情况下会失败。
- ✅ 正确:
os.IsNotExist(err) - ❌ 不可靠:
err == os.ErrNotExist或strings.Contains(err.Error(), "no such file")
避免用 os.Open 或 os.OpenFile 判断存在性
虽然 os.Open 在文件不存在时也会返回 os.ErrNotExist,但它有副作用:成功时会打开并持有文件描述符,哪怕你立刻 Close() 也增加了资源开销和出错概率(比如忘记关闭、并发竞争)。而 os.Stat 是只读元数据查询,更轻量、语义更清晰。
-
os.Stat:查“有没有”,不打开文件 -
os.Open:查“能不能读”,顺带打开——这不是存在性检查的本意 - 若后续真要读文件,可复用
os.Stat结果判断后再os.Open,避免重复系统调用
注意符号链接与 os.Lstat 的区别
默认 os.Stat 会自动解引用符号链接(即检查链接指向的目标是否存在)。如果只想确认符号链接本身是否存在(不管目标是否有效),应改用 os.Lstat:
_, err := os.Lstat("/path/to/symlink")
if err != nil && os.IsNotExist(err) {
// 连符号链接文件本身都不存在
} else if err == nil {
// 符号链接存在(无论其目标是否有效)
}
这个细节在部署脚本、配置检查或容器镜像构建中容易被忽略——你以为删掉了目标文件就等于“链接失效”,其实链接文件还在磁盘上。










