在 Go 中，应避免通过 err.Error() 字符串匹配来判断错误类型；更符合惯用法的方式是使用预定义错误变量（如 io.EOF）、类型断言（如 *os.PathError）或类型开关，以提升代码健壮性、可移植性和可读性。
在 go 中，应避免通过 `err.error()` 字符串匹配来判断错误类型；更符合惯用法的方式是使用预定义错误变量（如 `io.eof`）、类型断言（如 `*os.patherror`）或类型开关，以提升代码健壮性、可移植性和可读性。
Go 的错误处理哲学强调“错误即值”，error 是一个接口，其实现类型千差万别——可能是标准库导出的全局变量（如 io.EOF），也可能是包内部构造的结构体指针（如 *os.PathError 或 *net.OpError）。若依赖 err.Error() 的字符串内容做条件判断（例如 strings.Contains(err.Error(), "peer reset")），将导致代码脆弱：字符串消息可能随 Go 版本升级、操作系统差异或本地化设置而变更，且无法静态检查，极易引发漏判或误判。
✅ 推荐方式一：直接比较预定义错误变量
当文档明确说明函数可能返回特定导出错误时，应直接使用 == 比较：
_, err := file.Read(buf)
if err == io.EOF {
// 正常结束，无需记录日志
return nil
}
if err != nil {
return fmt.Errorf("read failed: %w", err)
}这类错误（如 io.EOF、os.ErrNotExist、http.ErrUseLastResponse）是包级导出的 var，语义稳定、零分配、线程安全，是最高效且最地道的判断方式。
✅ 推荐方式二：类型断言（Type Assertion）
当需访问错误内部字段（如路径、操作名、底层原因）时，应通过类型断言获取具体错误类型：
_, err := os.Open("/tmp/missing")
if err != nil {
if pathErr, ok := err.(*os.PathError); ok {
log.Printf("Path error on %q: %v", pathErr.Path, pathErr.Err)
// 可进一步区分：pathErr.Op == "open"，pathErr.Err == syscall.ENOENT
return handleMissingFile(pathErr.Path)
}
return fmt.Errorf("unexpected error: %w", err)
}注意：断言目标类型必须与实际返回类型严格一致（包括指针/值语义）。*os.PathError 是常见模式，因多数系统错误由指针包装；而 net.OpError 通常也以指针形式返回，可用于提取 Op、Net 和 Err 字段。
✅ 推荐方式三：类型开关（Type Switch）处理多错误类型
当一个操作可能返回多种可识别错误类型时，类型开关比嵌套 if 更清晰、易维护：
switch e := err.(type) {
case *os.PathError:
if e.Err == syscall.ENOENT {
return handleNotFound(e.Path)
}
case *net.OpError:
if e.Op == "dial" && e.Err != nil {
return handleDialFailure(e.Addr.String())
}
case *os.LinkError:
log.Printf("link operation failed: %v", e)
return nil // 忽略链接错误
default:
if err != nil {
return fmt.Errorf("unhandled error: %w", err)
}
}⚠️ 重要注意事项
- 勿假设未文档化的错误类型：仅对官方文档明确承诺的错误类型进行断言（如 os.Open 文档注明可能返回 *os.PathError）。盲目断言 *os.SyscallError 等内部类型会导致兼容性风险。
- 优先使用 %w 包装错误：在自定义错误链中，用 fmt.Errorf("...: %w", err) 保留原始错误类型，确保上游仍可做类型断言。
-
警惕 errors.Is 和 errors.As（Go 1.13+）：现代 Go 推荐使用标准库提供的错误检查工具：
if errors.Is(err, os.ErrNotExist) { ... } // 判断是否为同一错误或其包装 var pathErr *os.PathError if errors.As(err, &pathErr) { ... } // 安全类型断言，支持嵌套包装它们能正确处理 fmt.Errorf("wrap: %w", err) 构建的错误链，是类型断言的增强替代方案。
总结而言，Go 错误过滤的惯用路径是：先查文档 → 有导出变量则 == 比较 → 需字段访问则 errors.As 断言 → 多类型分支用 errors.Is + 类型开关 → 仅当完全无解时才谨慎考虑字符串匹配（并加注释说明限制）。坚守此原则，方能写出跨版本、跨平台、可持续演进的健壮 Go 代码。
