如何在 Golang 中将结构体对象序列化为 JSON 字符串-Golang-PHP中文网

go的json.marshal仅序列化首字母大写的导出字段，小写字段被静默忽略；需用struct tag自定义键名、omitempty省略零值，time.time等特殊类型需额外处理。

如何在 golang 中将结构体对象序列化为 json 字符串

Go 的 json.Marshal 能直接把结构体转成 JSON 字符串，但默认行为常让人踩坑——比如字段名全小写、空字段不忽略、时间变成数字戳。

结构体字段必须是导出的（首字母大写）

Go 的 json 包只能序列化导出字段。如果字段名是 name 或 id 这种小写开头，json.Marshal 会直接忽略它，结果里啥都没有。

解决办法很简单：确保字段首字母大写，并用 json tag 显式声明键名：

type User struct {
    Name  string `json:"name"`
    Email string `json:"email"`
    Age   int    `json:"age"`
}

注意：`json:"name"` 中的反引号不能漏，否则编译报错；tag 值里不要加空格，比如 `json:"name "` 会导致键名带空格。

处理零值字段（omitempty）

空字符串 ""、零值 0、false、nil 指针或 slice 默认仍会出现在 JSON 中。多数 API 不想要这些冗余字段。

加 omitempty 就能跳过零值：

type Config struct {
    Timeout int    `json:"timeout,omitempty"`
    Host    string `json:"host,omitempty"`
    Debug   bool   `json:"debug,omitempty"`
}

但要注意：omitempty 对指针、接口、map、slice、数组生效，对普通 struct 字段只判断其内部是否全为零值（不是“是否为 nil”）；另外，它不会跳过显式赋值为零值的字段，比如 Timeout: 0 仍会被序列化——除非你用指针类型 *int 并设为 nil。

Alibabacloud Sdk Client Initialization For Golang

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

时间字段默认序列化成 Unix 时间戳

如果结构体里有 time.Time 字段，json.Marshal 默认输出的是秒级时间戳（float64），不是 ISO8601 字符串，前端很难读。

正确做法是自定义类型并实现 MarshalJSON 方法：

type ISOTime time.Time

func (t ISOTime) MarshalJSON() ([]byte, error) {
    return []byte(`"` + time.Time(t).Format(time.RFC3339) + `"`), nil
}

type Event struct {
    CreatedAt ISOTime `json:"created_at"`
}

别直接在原生 time.Time 上加 tag（如 json:"created_at,string"）——那只会让时间变成带引号的数字字符串，比如 "1712345678"，不是你想要的 "2024-04-05T12:34:56Z"。