在 Go 中，将未导出的 error 接口嵌入结构体（如 type Err struct { error }）不会导出该字段，但结构体仍自动满足 error 接口——因其获得 Error() string 方法；访问 e.error 字段会编译失败，但可安全调用 e.Error()（需确保非 nil）。
在 go 中，将未导出的 `error` 接口嵌入结构体（如 `type err struct { error }`）不会导出该字段，但结构体仍自动满足 `error` 接口——因其获得 `error() string` 方法；访问 `e.error` 字段会编译失败，但可安全调用 `e.error()`（需确保非 nil）。
在 Go 语言中，嵌入（embedding）是一种关键的组合机制：当一个类型被嵌入结构体时，其方法集会被“提升”（promoted）到外层结构体上。但需特别注意——嵌入的是类型本身，而非字段名的导出性。
以如下定义为例：
package foo
type Err struct {
error // 嵌入内置 error 接口（未导出标识符）
}
此处 error 是 Go 内置的预声明接口类型（type error interface{ Error() string }），它本身不是导出标识符（小写开头），因此嵌入后生成的匿名字段名为 error，按 Go 导出规则属于未导出字段。这意味着：
- ✅ Err 类型自动拥有 Error() string 方法（由嵌入的 error 接口提升而来），因此 Err 完全满足 error 接口；
- ❌ 无法从其他包直接访问 e.error 字段（如 e.error = errors.New(...) 会导致编译错误：cannot refer to unexported field or method error）；
- ✅ 可以安全调用 e.Error()（前提是 e.error 字段非 nil），也可将 e 直接传给 fmt.Println、errors.Is 等接受 error 的函数（Go 会自动类型断言并调用 Error()）。
正确用法示例（在 main 包中）：
package main
import (
"errors"
"fmt"
"foo"
)
func main() {
// ✅ 正确：通过构造函数或显式初始化设置底层 error
e := foo.Err{error: errors.New("Hello world!")}
fmt.Println(e.Error()) // 输出: Hello world!
fmt.Println(e) // 输出: Hello world! （因实现了 error）
// ⚠️ 危险：零值 Err 的 error 字段为 nil，调用 Error() 将 panic
var e2 foo.Err
// fmt.Println(e2.Error()) // panic: runtime error: invalid memory address...
}
? 关键注意事项：
- 嵌入 error 不等于“导出字段”，而是“继承方法”——导出性仅作用于字段名和类型名，不影响方法提升；
- 必须显式初始化嵌入的 error 字段（如使用结构体字面量或构造函数），否则其值为 nil，任何对 Error() 的调用都会触发 panic；
- 若需封装错误并添加额外行为（如上下文、堆栈），推荐使用组合而非嵌入，或配合导出字段（如 Err struct { Cause error }）+ 显式实现 Error() 方法，以提升可维护性与清晰度。
总之，嵌入 error 是一种简洁实现错误包装的方式，但务必牢记其字段不可见、不可直接赋值，且 nil 安全需由使用者保障。
