本文介绍了在 go 中为自定义时间类型添加 json 编解码能力的同时，保持对 time.time 方法的自然访问的最佳实践——通过结构体嵌入而非类型别名，并详解其用法、限制与注意事项。
在 Go 中，若需为时间类型添加自定义序列化逻辑（如统一时区、精简格式等），开发者常会定义新类型，例如 type MyTime time.Time。但这种类型别名方式会导致所有 time.Time 方法不可直接调用，每次调用前必须显式转换（如 time.Time(t).Add(...)），不仅冗长易错，还破坏可读性与维护性。
更优解是采用结构体嵌入（embedding）：
type MyTime struct {
time.Time
}该写法使 MyTime 自动获得 time.Time 的所有导出方法（如 Add, Before, Format 等），无需手动转换即可调用：
t := MyTime{time.Now()}
t.Time = t.Add(1 * time.Hour) // ✅ 直接使用 Add，再赋值回嵌入字段同时，你仍可自由实现接口方法，例如定制 JSON 序列化：
func (t MyTime) MarshalJSON() ([]byte, error) {
return json.Marshal(t.Format("2006-01-02T15:04:05Z07:00"))
}
func (t *MyTime) UnmarshalJSON(data []byte) error {
var s string
if err := json.Unmarshal(data, &s); err != nil {
return err
}
parsed, err := time.Parse("2006-01-02T15:04:05Z07:00", s)
if err != nil {
return err
}
t.Time = parsed
return nil
}⚠️ 重要限制说明：
嵌入虽提供方法继承，但不提供类型兼容性。MyTime 仍不是 time.Time，因此不能直接传给接收 time.Time 参数的函数，也不能直接赋值给 time.Time 变量：
// ❌ 编译错误 // fn(t) // fn expects time.Time, not MyTime // var x time.Time = t // ✅ 正确用法：显式访问嵌入字段 fn(t.Time) // 传入内部 time.Time var x time.Time = t.Time // 赋值需取 .Time t.Time = time.Now() // 修改内部值
相比之下，类型别名 type YourTime time.Time 虽能通过强制转换实现互通，但完全失去方法继承，每次计算都需双重转换（如 YourTime(time.Time(t).Add(...))），显著降低代码质量。
✅ 总结建议：
- 优先使用 struct{ time.Time } 嵌入方式扩展时间类型；
- 利用嵌入自动继承全部 time.Time 方法，大幅减少类型转换；
- 实现 MarshalJSON/UnmarshalJSON 等接口时，操作 t.Time 字段即可；
- 记住：嵌入 ≠ 类型等价，跨上下文使用时仍需显式 .Time 访问；
- 若需更高程度的透明互操作（极少数场景），可结合泛型约束或包装器函数，但通常不推荐牺牲类型安全换取便利。
此模式已在标准库（如 http.Header 嵌入 map[string][]string）和主流框架中广泛验证，是 Go 生态中扩展基础类型的标准、清晰且可维护的实践。
