在 go 中，若多个结构体需共享相同字段（如 code 和 reason），应通过结构体嵌入而非接口来实现字段复用；接口无法约束具体字段及其标签，而嵌入可自然继承字段、json 标签及可访问性，是更简洁、类型安全的方案。
Go 的接口（interface）用于定义行为（方法集合），不能用于约束结构体的字段名、类型或结构标签（如 json:"code"）。因此，像 interface { Code stringjson:"code"} 这样的写法在语法上非法，Go 编译器会直接报错：invalid interface field tag。
正确的做法是使用结构体嵌入（embedding）——将公共字段封装为一个独立结构体，然后在其他结构体中匿名嵌入它。这不仅复用了字段定义和 JSON 标签，还自动提升嵌入字段为外层结构体的可导出字段，支持直接访问与序列化。
以下为推荐实现：
// 定义公共响应字段结构体（注意：字段首字母大写以导出）
type APIResult struct {
Code string `json:"code"`
Reason string `json:"reason"`
}
// 具体业务结构体嵌入 APIResult
type UploadResult struct {
Filename string `json:"filename"`
APIResult // 匿名嵌入：字段 Code/Reason 直接可用
}
// 通用处理函数，接收嵌入后的结构体值或指针
func FailExit(r APIResult) {
fmt.Println("Error code:", r.Code)
fmt.Println("Reason:", r.Reason)
}使用示例：
func main() {
result := UploadResult{
Filename: "report.pdf",
APIResult: APIResult{
Code: "ERR_UPLOAD_FAILED",
Reason: "file size exceeds limit",
},
}
// 可直接访问嵌入字段
fmt.Println(result.Code) // 输出: ERR_UPLOAD_FAILED
fmt.Println(result.Reason) // 输出: file size exceeds limit
// 传入通用函数
FailExit(result.APIResult) // 或直接 FailExit(result) —— 因 APIResult 是字段，需显式选择
}⚠️ 注意事项：
- 若希望 FailExit 能直接接收 UploadResult（而非仅 APIResult），可将函数参数改为接收 指针 并利用嵌入的“提升”特性（需确保嵌入字段可寻址），但更清晰的做法仍是显式传递 result.APIResult，语义明确且无歧义；
- 所有字段必须导出（首字母大写），否则无法被外部包访问或 JSON 序列化；
- 嵌入结构体的 JSON 标签会被完整继承，json.Marshal(UploadResult{}) 将正确输出 "code" 和 "reason" 字段；
- 如需扩展行为（如统一错误格式化），可在 APIResult 上定义方法，所有嵌入它的结构体均可直接调用。
总结：Go 中“字段复用”属于数据结构组合问题，结构体嵌入是标准、高效且符合语言哲学的解法；接口适用于抽象行为，而非约束数据形状。
