最可靠方式是用os.Stat并配合os.IsNotExist(err)判断文件是否存在;直接err!=nil或错误字符串比较均不可靠,且需注意权限不足时os.IsNotExist返回false。

用 os.Stat 判断文件是否存在最可靠
Go 没有单独的 os.Exists 函数(旧版曾有,但已弃用),正确做法是调用 os.Stat 并检查错误类型。直接判断 err == nil 只能说明路径可访问,而 os.IsNotExist(err) 才能明确确认“不存在”。
-
os.Stat会尝试获取文件元信息,无论路径是文件、目录还是符号链接,只要存在且可读,就返回nil错误 - 如果返回非
nil错误,必须用os.IsNotExist(err)判断是否真为“不存在”,不能直接比对错误字符串或用err != nil简单取反 - 注意:
os.IsNotExist对权限不足(permission denied)也返回false,此时错误不是“不存在”,而是“不可访问”
os.Stat 的典型用法和常见误判
下面这段代码常被复制,但它隐含陷阱:
_, err := os.Stat("/path/to/file")
if err != nil {
// ❌ 错误:这里 err 可能是 permission denied、no such device 等,不一定是文件不存在
fmt.Println("文件不存在")
}
正确写法必须显式检查错误类型:
_, err := os.Stat("/path/to/file")
if err != nil {
if os.IsNotExist(err) {
fmt.Println("文件确实不存在")
} else {
fmt.Printf("其他错误:%v", err)
}
return
}
fmt.Println("文件存在")
想同时区分文件和目录?继续看 os.FileInfo
os.Stat 返回的 os.FileInfo 可用于进一步判断类型:
诚客在线考试是由南宁诚客网络科技有限公司开发的一款手机移动端的答题网站软件,它应用广泛适合各种学校、培训班、教育机构、公司企业、事业单位、各种社会团体、银行证券等用于学生学习刷题、员工内部培训,学员考核、员工对公司制度政策的学习……可使用的题型有:单选题、多选题、判断题支持文字,图片,音频,视频、数学公式。可以设置考试时间,答题时间,考试次数,是否需要补考,是否可以看到自己成绩。练习模式,支持学生
立即学习“go语言免费学习笔记(深入)”;
- 用
fi.IsDir()区分是目录还是普通文件 - 用
fi.Mode()&os.ModeSymlink != 0检查是否为符号链接 - 注意:
os.Stat对符号链接会自动解引用;如需获取链接本身信息,改用os.Lstat
fi, err := os.Stat("/path/to/file")
if err != nil {
if os.IsNotExist(err) {
// 不存在
}
return
}
if fi.IsDir() {
fmt.Println("这是个目录")
} else {
fmt.Println("这是个文件")
}
性能与并发场景下的注意事项
频繁调用 os.Stat 做存在性检查(比如轮询)会影响性能,尤其在 NFS 或容器挂载路径上延迟明显。这时要考虑:
- 是否真需要每次检查?能否缓存状态或改用文件系统通知(
fsnotify) - 多个 goroutine 同时检查同一路径不会冲突,但
os.Stat是系统调用,高并发下 syscall 开销不可忽略 - 不要用
os.Open+defer f.Close()替代os.Stat来判断存在性——它开销更大,还可能因忘记关闭导致 fd 泄露
真正容易被忽略的是:即使 os.Stat 返回存在,后续 os.Open 仍可能失败——因为文件可能在两次调用之间被删除、重命名或权限变更。存在性检查不能替代容错处理。









