自定义错误类型通过实现 error 接口、使用 errors.As/Is 判断、哨兵错误、错误包装和带状态码错误，提升 Go 项目错误处理的清晰度与健壮性。
在 Go 语言中，错误处理是通过返回 error 类型值来实现的。虽然 errors.New 和 fmt.Errorf 能满足基本需求，但在复杂项目中，我们常需要携带更多信息或区分错误类型。这时，自定义错误类型就显得尤为重要。以下是 Golang 中实现和使用自定义错误类型的常用方法汇总。
1. 实现 error 接口来自定义错误类型
Go 的 error 是一个接口：
type error interface { Error() string }只要结构体实现了 Error() 方法，就可以作为错误类型使用。
示例：定义一个网络请求超时错误：
立即学习“go语言免费学习笔记（深入）”；
type TimeoutError struct {URL string
Reason string
}
func (e *TimeoutError) Error() string {
return fmt.Sprintf("timeout accessing %s: %s", e.URL, e.Reason)
}
使用方式：
return &TimeoutError{URL: "https://example.com", Reason: "connection timeout"}2. 使用 errors.Is 和 errors.As 进行错误判断
从 Go 1.13 开始，errors 包提供了 Is 和 As 函数，用于更精确地判断错误类型。
例如，判断是否为超时错误：
if err := fetch(); err != nil {if te, ok := err.(*TimeoutError); ok {
log.Printf("Timeout on URL: %s", te.URL)
}
}
更推荐使用 errors.As，它能处理包装过的错误：
if errors.As(err, &te) {
log.Printf("Timeout on URL: %s", te.URL)
}
3. 使用哨兵错误（Sentinel Errors）
对于不需要附加信息的固定错误，可定义全局错误变量，称为“哨兵错误”。
var ErrNotFound = errors.New("resource not found")func FindItem(id int) (*Item, error) {
if item, exists := db[id]; !exists {
return nil, ErrNotFound
}
return &item, nil
}
调用方可用 errors.Is 判断：
// 处理未找到的情况
}
4. 错误包装与信息增强（Go 1.13+）
使用 %w 格式化动词可以包装原始错误，保留调用链信息。
return fmt.Errorf("failed to process user %d: %w", userID, err)
}
之后仍可用 errors.Is 或 errors.As 解包判断原始错误类型。
5. 带状态码的自定义错误
在 Web 服务中，常需返回 HTTP 状态码。可扩展错误类型包含状态码信息：
type HTTPError struct {Code int
Msg string
}
func (e *HTTPError) Error() string { return e.Msg }
使用示例：
return &HTTPError{Code: 403, Msg: "forbidden access"}在中间件中可通过类型断言提取状态码：
if httpErr, ok := err.(*HTTPError); ok {w.WriteHeader(httpErr.Code)
}
基本上就这些。合理设计自定义错误类型，能让错误处理更清晰、健壮，尤其在大型项目中非常关键。关键是实现 Error() 方法，并结合 errors.As 和 errors.Is 做类型判断，必要时使用错误包装传递上下文。不复杂但容易忽略细节。
