Go语言创建自定义错误需实现error接口，核心方法是Error() string。使用errors.New可创建不可变的简单错误值，相同字符串生成相等的错误，适合固定描述场景。fmt.Errorf支持格式化输出和错误包装，通过%w动词嵌套底层错误，便于构建上下文信息并支持errors.Is和errors.As检查。当需携带额外字段（如错误码、字段名）或行为方法时，应定义结构体类型并实现Error方法及扩展方法，如StatusCode。为支持错误链，可在结构体中嵌入error字段，并在Error中组合输出。处理错误时避免用==或字符串匹配，推荐用errors.Is判断目标错误是否存在链中，用errors.As提取特定错误类型以获取详细信息。Go错误设计强调显式处理、组合性与诊断能力，优先使用fmt.Errorf与%w，仅在需要结构化数据时定义自定义类型。
Go 语言中创建自定义错误，核心是让类型实现 error 接口（即有 Error() string 方法），而不是必须继承某个基类。标准库的 errors 包和 fmt 包提供了轻量、灵活且符合 Go 风格的错误构造方式。
用 errors.New 快速创建简单错误
适用于不需要携带额外上下文、仅需一个固定描述的场景。它返回一个预定义的、不可变的错误值。
例如：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
err := errors.New("failed to open config file")
注意：errors.New 返回的是一个指针（内部用私有结构体实现），所以多次调用相同字符串会得到相等的错误值（可用于直接比较）：
立即学习“go语言免费学习笔记（深入）”；
err1 := errors.New("not found")
err2 := errors.New("not found")
fmt.Println(err1 == err2) // true
用 fmt.Errorf 带格式化信息和嵌套错误
当需要动态拼接错误消息（如含变量、路径、状态码），或要包装底层错误时，fmt.Errorf 是首选。
- 基础用法：类似
fmt.Sprintf，但返回error - 带错误包装（Go 1.13+）：用
%w动词包裹另一个 error，支持errors.Is和errors.As
例如：
path := "/etc/config.yaml"
err := fmt.Errorf("read config: %w", os.Open(path)) // 包装 open 错误
// 或带上下文：
err := fmt.Errorf("failed to parse user %d: %v", uid, parseErr)
定义结构体类型实现自定义错误
当错误需要携带字段（如错误码、请求 ID、重试次数）、支持行为方法（如是否可重试、HTTP 状态码），就应定义自己的错误类型。
示例：
type ValidationError struct {
Field string
Message string
Code int
}
func (e *ValidationError) Error() string {
return fmt.Sprintf("validation error in %s: %s", e.Field, e.Message)
}
func (e *ValidationError) StatusCode() int {
return e.Code
}
// 使用：
err := &ValidationError{Field: "email", Message: "invalid format", Code: 400}
注意：如果想支持错误链，可在结构体中嵌入另一个 error 字段，并在 Error() 中组合输出，同时用 %w 包装它。
检查与处理错误链：errors.Is 和 errors.As
不要用 == 或 strings.Contains 判断错误类型——这脆弱且不支持包装。推荐使用标准库提供的语义化工具：
-
errors.Is(err, target)：判断 err 是否等于 target，或是否在它的错误链中（支持多层%w） -
errors.As(err, &target)：尝试将 err 或其包装链中的某个错误转换为指定类型（用于获取自定义错误的字段）
例如：
if errors.Is(err, os.ErrNotExist) {
log.Println("config file missing, using defaults")
}
var valErr *ValidationError
if errors.As(err, &valErr) {
log.Printf("Validation failed on %s: %s", valErr.Field, valErr.Message)
}
基本上就这些。Go 的错误设计强调显式、可组合、可诊断——不靠异常机制，而靠接口、包装和工具函数协同工作。写自定义错误时，优先考虑是否真需要结构体；多数情况，fmt.Errorf + %w 已足够清晰有力。
