Go的error接口仅需Error()方法即可工作,因其采用鸭子类型:只要类型有匹配签名的Error()方法就自动实现该接口;字符串字面量不满足,须用errors.New或fmt.Errorf包装。

error 接口只靠一个 Error() 方法就能工作,是因为它不依赖类型继承
Go 的 error 接口定义极简:type error interface { Error() string }。它不要求你“声明实现”,也不关心你是不是结构体——只要某个类型(哪怕是 func(int) int 或 []byte)有签名完全匹配的 Error() string 方法,就自动满足该接口。这是 Go “鸭子类型”最直接的体现:不看你是谁,只看你能不能叫(Error())。
常见错误现象:cannot use "xxx" (untyped string) as error value,本质是你写了 return "failed",而字符串字面量没有 Error() 方法,也没实现 error 接口。必须用 errors.New("failed") 或 fmt.Errorf("...") 包一层,它们返回的是已实现该接口的类型实例。
为什么 errors.New 返回的是 *errorString 而不是 errorString
标准库中 errorString 的 Error() 方法是用指针接收器定义的:func (e *errorString) Error() string。这意味着只有 *errorString 类型才拥有这个方法,errorString 值本身的方法集是空的。
-
var err error = errorString{"x"}→ 编译失败:类型不匹配 -
var err error = &errorString{"x"}→ 正确:指针类型实现了error
如果你自己定义错误结构体并用指针接收器实现 Error(),也必须返回指针才能赋值给 error 接口变量;若改用值接收器(func (e errorString) Error() string),则值和指针都可赋值——但标准库选指针,是为了避免拷贝、支持后续扩展字段(如错误链中的 Unwrap())。
fmt.Println 为什么会自动调用 Error() 方法
这不是语法糖,而是 fmt 包的显式逻辑:当它检测到传入值实现了 error 接口,就会调用其 Error() 方法来获取字符串表示。这跟 Stringer 接口的处理方式一致。
你可以验证这一点:
type MyErr struct{ msg string }
func (e *MyErr) Error() string {
fmt.Println("Error() called!") // 这行会在 fmt.Println(e) 时打印
return e.msg
}
fmt.Println(&MyErr{"boom"}) // 输出两行:先 "Error() called!",再 "boom"
注意:这种自动调用只发生在 fmt 系列函数中,其他地方(比如日志写入、HTTP 响应体)不会隐式触发,必须显式调用 err.Error()。
自定义错误要不要带额外字段,取决于你是否需要断言或透传上下文
纯提示性错误(如 "file not found"),用 fmt.Errorf 足够;但一旦需要区分错误种类、携带状态码、原始参数或支持错误链,就必须定义结构体。
- 结构体字段必须导出(首字母大写),否则其他包无法访问或断言
- 推荐用指针接收器实现
Error(),避免不可比较字段(如sync.Mutex)导致结构体无法作为 map key 或参与 == 判断 - 若要支持
errors.Is/errors.As,需额外实现Unwrap()方法(返回嵌套错误)
最容易被忽略的一点:函数类型也能实现 error 接口,只要给它起个别名并绑定 Error() 方法——但这会让代码语义模糊,生产环境慎用。


















