自定义错误类型在 golang 中至关重要，因为内置错误类型无法满足复杂场景需求。其核心用途包括：1. 区分不同错误类型如网络与数据库错误；2. 携带错误码用于日志或前端展示；3. 支持格式化输出或上下文信息。实现 Error 接口只需定义结构体并实现 error() String 方法，例如定义包含 code 和 message 字段的 myerror 结构体，并格式化返回错误信息。注意事项包括：字段设为私有以确保不可变性、实现 unwrap() 方法以支持 errors.is/as、避免在 error() 中执行复杂操作。实用建议包括：通过接口抽象 errorcode 便于外部判断、组合使用标准错误与自定义错误以扩展功能、命名应具体如 apierror 或包名前缀如 httpclient.requesterror，并建议导出以便外部使用。
在 Golang 中，错误处理是程序设计的重要组成部分。标准库中的 error 接口虽然简单，但足够灵活，可以满足各种场景下的需求。要自定义错误类型并实现 error 接口，关键在于理解其设计哲学和常见用法。
为什么需要自定义错误类型
Golang 的内置错误类型（如 errors.New(“something went wrong”)）虽然方便，但在大型项目中往往不够用。我们常常需要区分不同的错误类型、携带额外信息或支持更复杂的判断逻辑。
比如：
立即学习“go语言免费学习笔记（深入）”；
- 区分网络错误和数据库错误
- 携带错误码用于日志或前端展示
- 支持格式化输出或上下文信息
这时候，使用自定义错误类型就显得非常必要。
如何正确实现 error 接口
Golang 的 error 接口定义如下：
type error interface { Error() string }
只要一个类型实现了 Error() 方法，它就可以作为错误返回。因此，自定义错误类型的步骤很简单：
- 定义一个结构体类型，包含你需要的字段
- 实现 Error() string 方法
例如：
type MyError struct { Code int Message string } func (e MyError) Error() string { return fmt.Sprintf("[%d] %s", e.Code, e.Message) }
这样你就可以像普通错误一样使用这个类型了：
err := MyError{Code: 400, Message: "Bad Request"} if err != nil { log.Println(err) }
常见注意事项
- 如果你想让错误不可变，可以把结构体字段设为私有，并通过构造函数创建
- 可以考虑实现 Unwrap() 方法，便于使用 errors.Is() 和 errors.As()
- 不建议在 Error() 方法里做复杂操作，容易导致 panic 或循环引用
怎么用好自定义错误：几个实用建议
使用接口判断错误类型
如果你希望外部能识别出具体的错误类型，可以通过接口来抽象判断逻辑：
type ErrorCode interface { Code() int }
然后让你的错误类型实现这个方法：
func (e MyError) Code() int { return e.Code }
这样调用方就可以用类型断言或者 errors.As() 来提取错误码了。
组合使用标准错误和自定义错误
有时候我们不需要从头开始写错误类型，可以组合已有的错误类型来扩展功能：
type WrappedError struct { Err error Context string } func (e WrappedError) Error() string { return fmt.Sprintf("%s: %s", e.Context, e.Err) }
这种方式适合做中间层封装，比如记录错误上下文、添加调试信息等。
错误类型命名建议
- 避免只叫 Error，容易冲突。推荐使用类似 APIError、DBError 这样的方式
- 如果是包级别的错误，可以在名字中带上包名，比如 httpclient.RequestError
- 错误类型建议导出（首字母大写），以便外部使用
结尾
总的来说，自定义错误类型并不复杂，但要真正用好，需要注意设计上的细节，比如是否可比较、是否携带元信息、如何解包等。这些看似小的地方，在实际开发中影响很大。
基本上就这些，不复杂但容易忽略。
