使用 os.IsNotExist() 配合 os.Stat() 是判断文件是否存在的推荐方式，因为 err == nil 仅表示路径存在且可访问，但无法精确区分“不存在”与其他错误；2. os.IsNotExist() 能准确识别底层系统错误中的“文件或目录不存在”情况，兼容不同平台的错误码；3. 不应使用字符串匹配或直接判断 err != nil 来推断文件不存在，这会导致不跨平台、不可靠的问题；4. os.IsNotExist() 对文件和目录均适用，若需判断是否为普通文件，应在确认存在后通过 fi.Mode().IsRegular() 进一步检查。
在 Go 语言中，判断文件是否存在最安全、推荐的方式是使用 os.IsNotExist() 配合 os.Stat() 或 os.Open() 的错误检查，而不是直接用 os.FileInfo 的返回值做存在性判断（因为 os.Stat() 成功本身即代表存在）。
为什么不能用 os.Stat() 返回的 err == nil 来“反推”存在？
其实可以——os.Stat() 成功（即 err == nil）就说明路径存在且可访问。但问题在于：你想处理的是“不存在”这个特定错误，而操作系统返回的错误类型多样（权限不足、路径过长、设备忙等），直接判 err != nil 不够精确。所以重点不是“怎么知道存在”，而是“如何干净地识别‘不存在’这一种情况”。
正确使用 os.IsNotExist() 判断文件不存在
os.IsNotExist() 是一个错误检查函数，它会递归判断底层错误是否由“文件或目录不存在”导致（兼容不同系统底层错误码，比如 Unix 的 ENOENT、Windows 的 ERROR_FILE_NOT_FOUND）。
- 它只对
error类型参数有效，且必须是os包产生的错误（如os.Stat、os.Open、os.Remove等返回的 error） - 不要对自定义错误或字符串错误调用它，会始终返回
false - 典型写法：
✅ 正确示例：
立即学习“go语言免费学习笔记（深入）”；
_, err := os.Stat("config.json")
if os.IsNotExist(err) {
fmt.Println("文件 config.json 不存在")
// 可在此创建默认配置
} else if err != nil {
fmt.Printf("其他错误：%v", err)
} else {
fmt.Println("文件存在")
}常见误区与替代方案
-
❌ 错误：用 os.IsNotExist(nil) —— 这会 panic 或返回 false，因为
nil不是有效 error - ❌ 错误：用 strings.Contains(err.Error(), "no such") —— 不跨平台、不可靠、易被翻译或格式改动破坏
-
✅ 替代：用 os.ReadFile() + 错误判断（更简洁，适合读小文件）
data, err := os.ReadFile("settings.toml")
if os.IsNotExist(err) { /* 不存在 */ } else if err != nil { /* 其他错误 */ } - ⚠️ 注意：os.IsNotExist() 对目录同样适用 —— 它判断的是“路径指向的条目不存在”，不区分文件或目录
如果想区分“文件不存在”和“是目录但不是文件”？
os.IsNotExist() 只管“不存在”。若已知路径存在，但需要确认它是普通文件（而非目录或符号链接），应检查 os.FileInfo.Mode().IsRegular()：
fi, err := os.Stat("path")
if os.IsNotExist(err) {
// 不存在
} else if err != nil {
// 其他错误
} else {
if !fi.Mode().IsRegular() {
fmt.Println("存在，但不是普通文件（可能是目录、symlink 等）")
}
}基本上就这些。核心就一条：用 os.IsNotExist(err) 处理“不存在”，别碰字符串匹配，也别假设所有非 nil error 都是不存在。
