在 Go 中，将未导出的 error 接口嵌入结构体（如 type Err struct { error }）不会导出该字段，但结构体仍自动满足 error 接口——因其获得 Error() string 方法；访问需通过指针或显式初始化，否则调用会 panic。
在 go 中，将未导出的 `error` 接口嵌入结构体（如 `type err struct { error }`）不会导出该字段，但结构体仍自动满足 `error` 接口——因其获得 `error() string` 方法；访问需通过指针或显式初始化，否则调用会 panic。
Go 的嵌入（embedding）机制本质是字段提升（field promotion）：当一个类型被嵌入结构体时，其方法集会被“提升”到外层结构体上，前提是嵌入字段本身可访问（即非私有字段名不阻碍方法调用）。值得注意的是，error 是语言预声明的内置接口，定义为：
type error interface {
Error() string
}
尽管 error 标识符小写、不导出（无法在其他包中作为类型名直接引用），但它在任何包内都可自由使用——这是 Go 语言规范赋予的特殊地位。因此，以下定义完全合法：
package foo
type Err struct {
error // 嵌入未导出的 error 接口字段
}
该结构体 Err 自动满足 error 接口，原因并非“继承”，而是：嵌入后，Err 类型的方法集包含 Error() string（来自 error 字段的提升方法），而满足接口只需方法签名一致。
然而，关键限制在于字段可见性：error 字段名小写，故在 foo 包外不可直接访问。这意味着如下代码在 main 包中非法：
e := foo.Err{}
e.error = errors.New("Hello world!") // ❌ 编译错误：cannot refer to unexported field 'error' in struct literal of type foo.Err
正确做法是提供导出的构造函数或设置方法：
// 在 foo 包中
func NewErr(err error) Err {
return Err{error: err}
}
// 或
func (e *Err) Set(err error) {
e.error = err
}
调用示例（main 包）：
e := foo.NewErr(errors.New("Hello world!"))
fmt.Println(e.Error()) // ✅ 输出 "Hello world!"
fmt.Println(e) // ✅ 同样输出（因 fmt.Println 调用 Error()）
⚠️ 重要注意事项：
- 若未初始化嵌入的 error 字段（即保持为 nil），直接调用 e.Error() 将触发 panic：panic: runtime error: invalid memory address or nil pointer dereference。因为 nil 接口值上调用方法等价于 nil 指针解引用。
- 解决方案：始终初始化，或在 Error() 方法中添加 nil 检查（若需自定义行为）：
func (e Err) Error() string {
if e.error == nil {
return "no error"
}
return e.error.Error()
}
总结：嵌入 error 是实现错误包装的惯用模式（如 fmt.Errorf、errors.Join 底层所用），它轻量且语义清晰；但务必牢记字段不可跨包访问，应通过导出 API 控制初始化，并警惕 nil 值导致的运行时 panic。
