自定义error需实现Error方法，携带上下文如错误码、堆栈，支持errors.As/Is解包，可嵌入error并实现Unwrap，还可定义行为接口如Retryable，提升错误处理灵活性与排查效率。
在Go语言中，error 是一个接口类型，定义如下：
type error interface {
Error() string
}
任何实现了 Error() 方法的类型都可以作为错误使用。虽然标准库中的 errors.New 和 fmt.Errorf 能满足大部分基础需求，但在复杂项目中，我们往往需要携带更多上下文信息，比如错误码、调用栈、分类标识等。这就需要自定义 error 类型。
1. 实现基本的自定义 Error 类型
最简单的自定义 error 是结构体实现 Error() 方法：
立即学习“go语言免费学习笔记（深入）”；
type MyError struct {
Code int
Message string
}
func (e *MyError) Error() string {
return fmt.Sprintf("[%d] %s", e.Code, e.Message)
}
使用方式：
return &MyError{Code: 404, Message: "not found"}
这样可以在错误中附加业务语义，比如 HTTP 状态码或服务错误编号。
2. 携带堆栈信息（Stack Trace）
标准 error 不记录调用栈，调试困难。可通过 runtime.Caller 或第三方库如 pkg/errors 添加堆栈追踪。
手动实现示例：
type ErrorWithStack struct {
Err error
File string
Line int
Func string
}
func (e *ErrorWithStack) Error() string {
return fmt.Sprintf("%s\nat %s:%d (%s)", e.Err, e.File, e.Line, e.Func)
}
创建时捕获调用位置：
pc, file, line, _ := runtime.Caller(1)
fname := runtime.FuncForPC(pc).Name()
return &ErrorWithStack{
Err: err,
File: file,
Line: line,
Func: fname,
}
这有助于快速定位错误源头。
3. 支持错误类型判断与提取（类型断言和 As/Is）
从 Go 1.13 开始，errors.As 和 errors.Is 成为标准做法，用于安全地解包错误链并判断类型或值。
例如，判断是否是某种自定义错误：
var myErr *MyError
if errors.As(err, &myErr) {
log.Printf("错误码: %d", myErr.Code)
}
要支持这种机制，你的 error 类型需保持可被 As 访问的字段导出，或实现特定行为逻辑。
如果你封装了底层 error，建议在结构体中嵌入 error 字段，并在 Error() 中递归调用：
type WrappedError struct {
Msg string
Err error // 嵌入原始错误
}
func (e *WrappedError) Error() string {
return e.Msg + ": " + e.Err.Error()
}
func (e *WrappedError) Unwrap() error {
return e.Err
}
有了 Unwrap() 方法，errors.Is 和 As 才能穿透包装层。
4. 错误分类与行为扩展
除了数据扩展，还可以通过接口定义错误行为。例如定义可重试错误：
type Retryable interface {
IsRetryable() bool
}
让某些 error 实现该接口：
func (e *NetworkError) IsRetryable() bool {
return true
}
调用方可以动态判断：
if retry, ok := err.(interface{ IsRetryable() bool }); ok && retry.IsRetryable() {
// 触发重试逻辑
}
或者更优雅地使用 errors.As 配合指针变量。
基本上就这些。自定义 error 的核心是：实现 Error() 方法、合理封装上下文、支持解包与类型识别、必要时附带行为逻辑。设计时注意不要过度复杂化，优先考虑可读性和排查效率。
