推荐使用 os.Stat 结合 os.IsNotExist 判断文件是否存在:os.Stat 获取文件信息,若 err 非 nil 且 os.IsNotExist(err) 为真则不存在;否则视为存在(含目录、符号链接等)。

在 Go 语言中,检查文件是否存在最常用、最推荐的方式是使用 os.Stat,而不是先用 os.IsNotExist 或直接判断错误类型——因为 os.Stat 本身就能安全、准确地反映文件状态,且兼容所有操作系统。
✅ 使用 os.Stat 判断文件是否存在(推荐)
os.Stat 尝试获取文件的元信息(如大小、修改时间、权限等)。如果文件不存在,它会返回一个非 nil 的 error;若存在,则 error 为 nil。关键点在于:不能只看 error 是否为 nil,还要用 os.IsNotExist 显式判断错误类型,避免把其他错误(如权限不足、路径过长)误判为“不存在”。
示例代码:
func fileExists(path string) bool {
_, err := os.Stat(path)
return !os.IsNotExist(err)
}
这个函数简洁可靠:只要不是 “文件不存在” 错误,就认为文件存在(包括目录、符号链接等,只要路径可访问)。
立即学习“go语言免费学习笔记(深入)”;
⚠️ 不要直接用 os.IsNotExist(err) 而不检查 err 是否为 nil
常见错误写法:
// ❌ 错误:err 可能是 nil,此时 os.IsNotExist(nil) 返回 false,逻辑反了
if os.IsNotExist(err) { ... }
正确做法是先确认 err 非 nil,再判断是否为 NotExist:
- ✅
err != nil && os.IsNotExist(err)→ 确实不存在 - ✅
err == nil→ 存在(或至少可访问) - ✅
err != nil && !os.IsNotExist(err)→ 其他错误(如 permission denied)
? 如果只想确认“普通文件”存在(排除目录、设备文件等)
os.Stat 返回的 os.FileInfo 支持 IsDir() 方法。结合使用可精确识别:
func isRegularFile(path string) bool {
info, err := os.Stat(path)
if err != nil || info.IsDir() {
return false
}
return true
}
注意:符号链接默认会被自动解析(即检查它指向的目标),如需检查链接本身是否存在,用 os.Lstat。
? 补充:os.Lstat 和 os.Stat 的区别
-
os.Stat:跟随符号链接,返回目标文件的信息 -
os.Lstat:不跟随符号链接,返回链接本身的信息(可用于判断软链接是否存在)
info, err := os.Lstat(path)
if err == nil && info.Mode()&os.ModeSymlink != 0 {
// 是符号链接
}
基本上就这些。用好 os.Stat + os.IsNotExist 组合,既简洁又健壮,是 Go 中检测文件存在的标准做法。










