Go 中实现结构体字段复用：通过嵌入而非接口定义公共字段

在 go 语言中，若多个结构体需共享相同字段（如 code 和 reason），不应尝试用“字段级接口”（语法不支持），而应采用结构体嵌入（embedding）机制——将公共字段封装为独立结构体并嵌入各目标结构体，从而自然获得字段继承与方法复用能力。

go 不支持类似其他语言中“字段签名接口”（即对接口成员直接声明 jsON 标签或字段类型），因此以下写法是非法的：

// ❌ 编译错误：interface cannot contain fields type apiResult interface {     Code   string `json:"code"`     Reason string `json:"reason"` }

正确且符合 Go 惯用法的解决方案是：定义一个公共结构体，并通过匿名嵌入（embedding）将其复用于各个结果类型中。这不仅提供字段共享，还天然支持方法接收者、JSON 序列化（标签保留）和字段提升（promoted fields）。

✅ 推荐实现方式

// 公共响应结构体：定义通用字段及其序列化标签 type APIResult Struct {     Code   string `json:"code"`     Reason string `json:"reason"` }  // 具体业务结构体：嵌入 APIResult，自动获得 Code/Reason 字段及 JSON 映射 type UploadResult struct {     Filename string `json:"filename"`     APIResult       // 匿名嵌入 → 字段被提升，可直接访问 ul.Code / ul.Reason }  // 通用错误处理函数：接收结构体值或指针均可（此处以值为例） func FailExit(result APIResult) {     fmt.Printf("Failure: [%s] %sn", result.Code, result.Reason) }  // 使用示例 func main() {     ul := UploadResult{         Filename: "report.pdf",         APIResult: APIResult{             Code:   "ERR_UPLOAD_INVALID",             Reason: "File size exceeds limit",         },     }      // ✅ 直接访问嵌入字段（字段提升）     fmt.Println(ul.Code)    // → "ERR_UPLOAD_INVALID"     fmt.Println(ul.Reason) // → "File size exceeds limit"      // ✅ 传入通用函数     FailExit(ul.APIResult) // 或直接 FailExit(ul.APIResult)，因 APIResult 是字段名 }

? 提示：嵌入后，UploadResult 实例可直接访问 Code 和 Reason（如 ul.Code），无需写 ul.APIResult.Code——这是 Go 的字段提升（field promotion）特性，使嵌入行为接近“继承”，但语义上仍是组合（composition over inheritance）。

⚠️ 注意事项

• 嵌入的是类型，不是接口：使用 APIResult（结构体）而非 apiResult（接口名）嵌入；接口适用于行为抽象（方法契约），结构体嵌入适用于数据复用。
• JSON 序列化正常工作：嵌入字段的 struct tag（如 json:”code”）会被 encoding/json 正确识别，json.Marshal(ul) 将输出包含 “code”, “reason”, “filename” 的完整对象。
• 避免指针嵌入陷阱：若嵌入 *APIResult，则需手动初始化，且字段提升失效（无法直接 ul.Code），故推荐嵌入值类型。
• 扩展性友好：后续可为 APIResult 添加方法（如 IsSuccess()、Error()），所有嵌入它的结构体均自动获得该方法。

综上，Go 中实现跨结构体的字段复用，首选结构体嵌入；它简洁、高效、符合语言哲学，且完全满足类型安全、序列化与逻辑复用需求。