2、Go内置error接口：error接口的定义、实现自定义error、errors.New与fmt.Errorf的使用

2.1 error接口的定义

Go语言通过一个极简的内置接口error统一了所有错误值的契约。该接口定义在builtin包中，是Go类型系统中最核心的接口之一。

// builtin.go 中的定义（简化）
type error interface {
    Error() string
}

任何实现了Error() string方法的类型都自动满足error接口，无需显式声明implements关键字。这种鸭子类型（Duck Typing）机制使得Go的错误处理具有极高的扩展性。

2.2 实现自定义error

通过定义结构体并实现Error()方法，可以创建携带丰富上下文的错误类型。这是构建安全错误码断言体系的第一步。

// 自定义错误类型：携带错误码和上下文
type AppError struct {
    Code    int    // 业务错误码
    Message string // 人类可读消息
    Err     error  // 包装的原始错误（可选）
}

// 实现 error 接口
func (e *AppError) Error() string {
    if e.Err != nil {
        return fmt.Sprintf("[%d] %s: %v", e.Code, e.Message, e.Err)
    }
    return fmt.Sprintf("[%d] %s", e.Code, e.Message)
}

// 使用示例
func ProcessOrder(id string) error {
    if id == "" {
        return &AppError{
            Code:    4001,
            Message: "订单ID不能为空",
            Err:     nil,
        }
    }
    // 正常处理...
    return nil
}

2.3 errors.New 与 fmt.Errorf 的使用

标准库提供了两种快速创建简单错误的方式，适用于不需要额外错误码或上下文的场景。

// errors.New 示例
var ErrNotFound = errors.New("resource not found")

func GetUser(id int) (User, error) {
    if id <= 0 {
        return User{}, ErrNotFound
    }
    // ...
}

// fmt.Errorf 示例（Go 1.13+ 支持 %w 包装）
func OpenConfig(path string) error {
    f, err := os.Open(path)
    if err != nil {
        // 使用 %w 包装原始错误，保留错误链
        return fmt.Errorf("打开配置文件失败: %w", err)
    }
    defer f.Close()
    // ...
    return nil
}

2.4 错误接口契约与断言体系

下图展示了Go内置error接口、自定义错误类型与标准库错误创建函数之间的关系，以及它们在安全错误码断言体系中的定位。

2.5 三种方式的对比与选择