在 go 中无法为字段定义接口，但可通过嵌入公共结构体来复用字段及 json 标签，既保持类型安全又支持通用函数操作，避免冗余代码和运行时反射。
Go 语言不支持“字段级接口”（如 interface { Code string \json:"code"` }），因为接口只能约束**方法**，不能约束结构体字段或其标签。若目标是统一访问Code和Reason` 字段并复用逻辑（如错误输出、序列化、校验），结构体嵌入（embedding）是标准、高效且符合 Go 惯用法的解决方案。
以下为推荐实现方式：
✅ 正确做法：嵌入公共结构体
定义一个轻量、可导出的结构体承载共用字段及其 JSON 标签：
type APIResult struct {
Code string `json:"code"`
Reason string `json:"reason"`
}然后在具体结果类型中嵌入它（注意：使用大写 APIResult 以保证可导出和外部可访问）：
type UploadResult struct {
Filename string `json:"filename"`
APIResult // 嵌入 —— 提供 Code 和 Reason 的字段访问与 JSON 序列化能力
}
type DownloadResult struct {
URL string `json:"url"`
APIResult // 同样复用
}此时，UploadResult 自动拥有 Code 和 Reason 字段（支持直接赋值/读取），且 JSON 编码时会正确合并标签：
u := UploadResult{
Filename: "report.pdf",
APIResult: APIResult{
Code: "ERR_UPLOAD_FAILED",
Reason: "file size exceeds limit",
},
}
data, _ := json.Marshal(u)
// 输出: {"filename":"report.pdf","code":"ERR_UPLOAD_FAILED","reason":"file size exceeds limit"}? 通用函数无需接口，直接接受嵌入体
因所有结果类型都包含 APIResult，通用函数可直接接收该类型（值传递或指针）：
func FailExit(r APIResult) {
fmt.Printf("❌ Failure [%s]: %s\n", r.Code, r.Reason)
}
// 调用示例
u := UploadResult{...}
FailExit(u.APIResult) // 显式提取嵌入字段
// 或更简洁地（若函数改为接收 *APIResult）：
func FailExitPtr(r *APIResult) {
fmt.Printf("❌ Failure [%s]: %s\n", r.Code, r.Reason)
}
FailExitPtr(&u.APIResult)? 提示：若需在 UploadResult 上直接调用 FailExit，可为其添加方法： func (u *UploadResult) FailExit() { FailExit(u.APIResult) }
⚠️ 注意事项
- 不要用接口模拟字段：试图用空接口 interface{} + 反射不仅性能差、类型不安全，还丢失编译期检查和 IDE 支持；
- 嵌入不是继承：UploadResult 并非 APIResult 的子类，而是组合关系；字段访问是扁平化的（u.Code 合法），但方法需显式定义；
- JSON 标签完全生效：嵌入后 json.Marshal 会自动内联字段，无需额外配置；
- 零开销抽象：嵌入在编译期完成，无运行时成本。
综上，结构体嵌入是 Go 中解决“字段复用+通用处理”问题的地道方案——简洁、高效、可维护，也是官方文档与主流项目（如 net/http、encoding/json）广泛采用的实践。
