Go语言如何处理错误码与跨平台兼容性

Go语言中正确处理系统错误码与跨平台兼容的关键在于善用Go 1.13引入的`errors.Is`——它通过调用底层错误的`Is`方法实现语义化、跨平台的错误判断，能可靠识别如权限拒绝（`os.ErrPermission`）或文件不存在（`fs.ErrNotExist`）等系统级错误，避免直接比较错误值或字符串匹配带来的Windows/Linux行为差异；但其有效性依赖于错误是否正确实现了`Is`方法，因此包装错误时必须使用`%w`保留错误链，自定义错误需显式实现`Is`，且需警惕未适配该机制的第三方库导致的静默失效——掌握这些细节，才能写出真正健壮、可移植的Go错误处理逻辑。

如何用 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 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 提取具体类型再判断。

本篇关于《Go语言如何处理错误码与跨平台兼容性》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！