Go 标准库不直接返回 os.ErrNotExist，而是返回底层系统调用错误（如 "no such file or directory"），应使用 os.IsNotExist() 进行跨平台、健壮的错误判断。
go 标准库不直接返回 `os.errnotexist`，而是返回底层系统调用错误（如 `"no such file or directory"`），应使用 `os.isnotexist()` 进行跨平台、健壮的错误判断。
在 Go 中，调用 os.OpenFile(fname, os.O_WRONLY, 0600) 打开一个不存在的文件时，返回的错误类型是 *os.PathError，其底层 Err 字段通常为 syscall.ENOENT（Unix）或类似平台特定错误，并非直接等于 os.ErrNotExist。这是因为 os.ErrNotExist 是一个预定义的哨兵错误（sentinel error），仅用于部分内部场景；而实际 I/O 操作返回的是封装后的路径错误，其语义等价但值不相等。
因此，绝不可使用 err == os.ErrNotExist 或 errors.Is(err, os.ErrNotExist)（后者虽在较新版本中可用，但非推荐惯用法）进行判断。正确的做法是使用标准库提供的语义化判断函数：
if os.IsNotExist(err) {
// 文件或目录确实不存在
}
os.IsNotExist 是 Go 官方推荐的、跨操作系统安全的判断方式。它内部会检查错误是否满足“不存在”语义，包括：
- 直接等于 os.ErrNotExist
- 底层 syscall 错误码为 ENOENT（Linux/macOS）、ERROR_FILE_NOT_FOUND（Windows）等
- 其他可能由不同文件系统或包装器产生的等效错误
✅ 正确示例：
package main
import (
"fmt"
"os"
)
func handleFileWrite(filename string) error {
f, err := os.OpenFile(filename, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0644)
if err != nil {
if os.IsNotExist(err) {
return fmt.Errorf("cannot create %q: parent directory does not exist", filename)
}
if os.IsPermission(err) {
return fmt.Errorf("permission denied when opening %q", filename)
}
return fmt.Errorf("failed to open file: %w", err)
}
defer f.Close()
_, _ = f.WriteString("hello world\n")
return nil
}
⚠️ 注意事项：
- os.IsNotExist 仅判断“不存在”，不表示“路径无效”或“权限不足”——这些需用 os.IsPermission、os.IsPathSeparator 等配合判断；
- 不要依赖错误字符串匹配（如 strings.Contains(err.Error(), "no such file")），这脆弱且不可移植；
- 在 Go 1.13+ 中，也可用 errors.Is(err, fs.ErrNotExist)（fs.ErrNotExist 是 os.ErrNotExist 的别名），但 os.IsNotExist 更直观、向后兼容性更好；
- 若需区分“文件不存在”与“目录不存在”，os.IsNotExist 对两者均返回 true；更细粒度判断需结合 os.Stat + os.IsNotExist + fi.IsDir()。
总结：始终优先使用 os.IsNotExist(err) 判断目标路径是否存在，这是 Go 生态中被广泛采用、经过充分测试的标准实践，确保代码健壮、可维护且跨平台一致。
