Errors.is 是跨平台判断系统级错误的推荐方式，支持 os.errpermission、fs.errnotexist 等标准错误，能正确处理包装错误和不同系统的错误码映射，但要求底层错误实现 is 方法。
如何用 errors.Is 判断系统级错误（比如权限拒绝、文件不存在）
go 1.13 引入的 errors.Is 是跨平台判断错误类型的推荐方式，但它只对实现了 Is(error) 方法的错误生效——标准库中 os.SyscallError、os.PathError 等都做了适配，但你得知道哪些底层错误能被它识别。
常见错误现象：直接用 err == os.ErrPermission 失败，或用 strings.Contains(err.Error(), "permission denied") 在 windows 上匹配不到（提示是 “access is denied”）。
-
errors.Is(err, os.ErrPermission)✅ 跨平台有效，内部会调用底层错误的Is()方法比对系统码 -
errors.Is(err, fs.ErrNotExist)✅ 替代过时的os.IsNotExist(err)，且兼容io/fs接口 - 别对自定义包装错误（如
fmt.Errorf("wrap: %w", err)）直接用==比对原错误，必须用errors.Is
为什么 os.IsNotExist 还没被完全淘汰，但要用得小心
这个函数本质是调用 errors.Is(err, fs.ErrNotExist)，但它在 Go 1.20 前不处理 io/fs 错误；现在虽已升级，但仍有兼容陷阱。
使用场景：维护老代码或需要明确区分“文件不存在”和“目录不存在”时（os.IsNotExist 对两者都返回 true，而 errors.Is(err, fs.ErrNotExist) 更统一）。
立即学习“go语言免费学习笔记（深入）”；
- Go 1.20+ 中
os.IsNotExist底层已转为调用errors.Is，行为一致 - 但在某些嵌入式或 syscall 封装层（如
cgo返回的裸errno），os.IsNotExist可能失效，此时必须手动用errors.Is(err, &fs.PathError{Op: "open", Err: syscall.ENOENT}) - Windows 下
ERROR_FILE_NOT_FOUND和ERROR_PATH_NOT_FOUND都会被映射为syscall.ENOENT，所以errors.Is(err, fs.ErrNotExist)覆盖更全
syscall.Errno 直接比对的适用边界和风险
当你要精确控制某类系统调用失败（比如只捕获 EAGAIN 做重试），且确定运行环境，才考虑直接比对 syscall.Errno。
性能影响小，但兼容性极差：linux 的 syscall.EAGAIN 等于 syscall.EWOULDBLOCK，但 macos 和 Windows 定义不同；而且 syscall 包在 Go 1.17+ 已被标记为“低级别”，不保证跨版本稳定。
- 仅限短生命周期、明确目标平台的工具类代码（如 Linux 服务器上的信号处理）
- 必须先断言错误类型：
if e, ok := err.(*os.SyscallError); ok && e.Err == syscall.EAGAIN，不能直接err == syscall.EAGAIN - Windows 下需用
syscall.ERROR_IO_PENDING或syscall.WSAEWOULDBLOCK，和 unix 完全不对应
跨平台错误包装时如何保留原始系统码
自己封装错误（比如加日志、上下文）时，如果丢掉底层 syscall.Errno，后续 errors.Is 就会失效。
正确做法是用 %w 格式动词包装，并确保底层错误实现了 Is() 方法——标准库的 os.PathError、os.SyscallError 都满足，但你自己写的错误类型必须显式实现。
- ✅ 正确包装：
fmt.Errorf("failed to open %s: %w", path, err)—— 只要err是标准库错误，errors.Is(wrappedErr, fs.ErrNotExist)仍为 true - ❌ 错误写法：
fmt.Errorf("failed to open %s: %s", path, err)—— 丢失了错误链，errors.Is失效 - 若需自定义错误类型，必须实现
Is(target error) bool方法，转发给内嵌的底层错误
最易被忽略的一点：第三方库返回的错误（比如 github.com/minio/minio-go）可能没正确实现 Is()，这时 errors.Is 会静默失败——遇到这种库，只能查文档确认它是否支持，或降级用 errors.As 提取具体类型再判断。