errors.New 和 fmt.Errorf 不够用，因它们无法携带上下文字段、支持类型断言或区分错误类别；需定义实现 error 接口的自定义类型，显式组合错误并导出字段，配合 Unwrap、Is 方法及 errors.As/Is 进行结构化错误处理。
为什么 errors.New 和 fmt.Errorf 不够用
当错误需要携带上下文（比如请求 ID、失败的文件路径、重试次数）、支持类型断言、或需区分不同错误类别（如网络超时 vs 权限拒绝）时，errors.New 返回的 *errors.errorString 是纯字符串包装，无法扩展字段或方法。fmt.Errorf 默认也不支持类型判断——即使加了 %w 也只是包装，底层仍无结构化数据。
定义带字段的自定义错误类型
直接实现 error 接口（即有 Error() string 方法），并添加你需要的字段。注意：不要嵌入 error 字段来“继承”，那会干扰类型断言；而是显式组合。
type PathError struct {
Op string
Path string
Err error
}
func (e *PathError) Error() string {
return e.Op + " " + e.Path + ": " + e.Err.Error()
}
func (e *PathError) Unwrap() error {
return e.Err
}
-
Unwrap()方法让该错误能被errors.Is/errors.As正确处理 - 字段全部导出（首字母大写），方便调用方读取上下文，例如
if pe, ok := err.(*PathError); ok { log.Println(pe.Path) } - 避免在
Error()中拼接敏感信息（如密码、token），日志打印时可能泄露
用 errors.As 和 errors.Is 做类型/值匹配
这是 Go 1.13+ 错误链的标准用法，替代旧式的字符串匹配或反射判断。
AlegroCart
下载
AlegroCart新功能：维类：包括在这两种线性长宽高或面积或体积长波产品尺寸允许与期权产品：让产品/期权组合独特的数量，尺寸，图像和型号。选择店铺标识管理 图片放大镜：显示一个图片放大上空盘旋时，产品形象弹出框。自定义错误报告：设置在管理员启用。 开发者只可以显示详细的信息。错误信息都写入到错误日志文件每天可以通过电子邮件发送给管理员。仓库皮卡航运模块：允许客户指定产品在商店的位置回升。增加了
err := doSomething()
var pathErr *PathError
if errors.As(err, &pathErr) {
log.Printf("failed on path: %s", pathErr.Path)
}
if errors.Is(err, fs.ErrPermission) {
// 处理权限错误
}
-
errors.As按错误链逐层检查是否可转换为目标类型指针，支持多层包装（如fmt.Errorf("wrap: %w", e)） -
errors.Is比较的是错误值相等性（底层调用Is()方法），不是字符串内容，所以自定义类型若需参与Is判断，应实现Is(target error) bool方法 - 别对
errors.As的第二个参数传值类型（如&PathError{}），必须传指针变量地址，否则匹配永远失败
何时用 fmt.Errorf 包装，何时新建类型
包装适合临时补充上下文且无需结构化提取的场景；新建类型适合错误语义明确、需被业务逻辑分支处理、或需暴露额外状态的场景。
立即学习“go语言免费学习笔记（深入）”；
- 用
fmt.Errorf("read config: %w", err)—— 日志友好，保留原始错误，但调用方不关心具体配置名 - 用
&ConfigLoadError{File: "/etc/app.yaml", Err: err}—— 当上层要根据File做 fallback 或告警分类时 - 如果多个地方都要返回同一种语义错误（如 “库存不足”），统一建类型比重复
fmt.Errorf("out of stock: %d", n)更易维护和测试 - 注意：频繁创建带堆分配的错误类型（如含 slice 或 map 字段）可能影响性能，简单场景优先用
fmt.Errorf+ 错误码常量
Is、要不要支持 Unwrap，都取决于你打算怎么用它。 
