本文介绍如何通过自定义类型别名 + MarshalJSON 实现全局、零侵入的 time.Time 字段 JSON 序列化为 Unix 时间戳（整数），避免为每个结构体重复编写序列化逻辑，并澄清 Go 类型系统中“方法继承”的常见误解。
本文介绍如何通过自定义类型别名 + `marshaljson` 实现全局、零侵入的 `time.time` 字段 json 序列化为 unix 时间戳（整数），避免为每个结构体重复编写序列化逻辑，并澄清 go 类型系统中“方法继承”的常见误解。
在 Go 的 JSON 序列化场景中，常需将 time.Time 字段以 Unix 时间戳（即 int64 秒级或毫秒级整数）形式输出，而非默认的 RFC3339 字符串（如 "2024-05-20T14:23:18Z"）。虽然可为每个含 time.Time 字段的 struct 单独实现 MarshalJSON，但面对大量结构体时，这种做法既冗余又难以维护。
一个更优雅的方案是定义一个类型别名并集中实现序列化逻辑。例如：
type Timestamp time.Time
⚠️ 但需特别注意：Go 中的命名类型（named type）不会自动继承其底层类型的方法。Timestamp 虽以 time.Time 为底层类型，但它是一个独立类型，不拥有 Unix()、Format() 等 time.Time 方法——这正是你遇到 t.Unix undefined 错误的根本原因。
✅ 正确做法是：在方法体内显式转换回 time.Time，再调用对应方法：
import (
"encoding/json"
"fmt"
"strconv"
"time"
)
type Timestamp time.Time
func (t Timestamp) MarshalJSON() ([]byte, error) {
// 方案一：使用 strconv（推荐用于纯数值，性能略优）
return []byte(strconv.FormatInt(time.Time(t).Unix(), 10)), nil
// 方案二：使用 fmt.Sprintf（语义清晰，可读性高）
// return []byte(fmt.Sprintf("%d", time.Time(t).Unix())), nil
}
? 补充说明：
time.Time(t)是类型转换（conversion），不是类型断言（type assertion）——因为Timestamp和time.Time具有相同底层类型（struct { ... }），且都非接口，因此允许直接转换。
使用示例：
type Event struct {
ID int `json:"id"`
CreatedAt Timestamp `json:"created_at"`
UpdatedAt Timestamp `json:"updated_at"`
}
func main() {
e := Event{
ID: 123,
CreatedAt: Timestamp(time.Date(2024, 5, 20, 10, 30, 0, 0, time.UTC)),
UpdatedAt: Timestamp(time.Now()),
}
data, _ := json.Marshal(e)
fmt.Println(string(data))
// 输出示例：{"id":123,"created_at":1716229800,"updated_at":1716235482}
}
? 关键注意事项：
- 若需毫秒级时间戳（如前端 JavaScript
Date.now()兼容），请改用time.Time(t).UnixMilli()（Go 1.17+）或手动计算：(time.Time(t).Unix()*1000 + int64(t.Nanosecond()/1e6))； - 反序列化（
UnmarshalJSON）需同步实现，否则json.Unmarshal将无法正确解析数字时间戳为Timestamp； - 所有原本使用
time.Time的字段，必须显式改为Timestamp类型才能生效；若需混合使用，可借助嵌入（embedding）或中间包装结构体，但会增加复杂度； - 不要尝试用类型断言
t.(time.Time)——它仅适用于接口值，而Timestamp是具体类型，断言必然失败。
总结：Go 的类型安全设计要求我们显式进行类型转换，而非依赖隐式继承。通过 Timestamp 别名 + time.Time(t).Unix() 转换，即可在保持代码简洁性的同时，实现全项目统一的 Unix 时间戳序列化策略，兼顾可维护性与性能。
