在 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）。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
✅ 推荐实现方式
// 公共响应结构体：定义通用字段及其序列化标签
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] %s\n", 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 中实现跨结构体的字段复用，首选结构体嵌入；它简洁、高效、符合语言哲学，且完全满足类型安全、序列化与逻辑复用需求。
