如何在 Go 中正确判断文件不存在错误

Go 标准库不直接返回 os.ErrNotExist，而是返回底层系统错误（如 "no such file or directory"），应使用 os.IsNotExist() 进行跨平台、健壮的错误判断。

Go 标准库不直接返回 `os.ErrNotExist`，而是返回底层系统错误（如 `"no such file or directory"`），应使用 `os.IsNotExist()` 进行跨平台、健壮的错误判断。

在 Go 中，调用 os.OpenFile()、os.Stat() 等 I/O 函数时，若目标路径不存在，返回的错误并非恒为 os.ErrNotExist，而通常是底层 *os.PathError，其内部 Err 字段为 syscall.ENOENT（Unix）或类似平台特定错误。直接与 os.ErrNotExist 比较会失败，因为该变量仅用于构造错误，而非实际返回值。

正确做法是使用标准库提供的错误分类函数：os.IsNotExist(err)。该函数专为此类场景设计，能安全识别所有已知表示“路径不存在”的错误类型（包括 os.ErrNotExist、各类 syscall.Errno 及其他兼容错误），具备跨操作系统鲁棒性。

以下是一个典型示例：

package main

import (
    "fmt"
    "os"
)

func main() {
    fname := "nonexistent.txt"
    f, err := os.OpenFile(fname, os.O_WRONLY|os.O_CREATE, 0644)
    if err != nil {
        if os.IsNotExist(err) {
            fmt.Printf("❌ 文件不存在，将创建新文件: %s\n", fname)
            // 可在此处执行创建逻辑，或提示用户
        } else {
            fmt.Printf("⚠️  其他打开错误: %v\n", err)
            return
        }
    } else {
        defer f.Close()
        fmt.Printf("✅ 文件已成功打开: %s\n", fname)
    }
}

⚠️ 注意事项：

• 不要使用 err == os.ErrNotExist 或 strings.Contains(err.Error(), "no such file") —— 前者语义错误，后者不可移植且易被干扰；
• os.IsNotExist() 是唯一推荐方式，它封装了所有平台差异；
• 同理，判断“文件已存在”应使用 os.IsExist()（例如在 os.Create() 失败时）；
• 若需区分“目录不存在”与“文件不存在”，os.IsNotExist() 对两者均返回 true，此时应结合 os.Stat() 的 os.FileInfo 类型进一步判断。

总之，os.IsNotExist() 是 Go 中处理路径存在性检查的标准、安全、可维护的惯用法，应作为所有文件/目录存在性判断的默认选择。