Go语言框架结构体转换Json方案 Go语言数据序列【常用】-Golang-PHP中文网

go 的 json.marshal 不自动转换字段名，必须用 json:"xxx" tag 显式指定小写下划线格式；小写字段不导出，会被忽略；嵌套结构体、切片、map 等均需逐字段打 tag；omitempty 按零值过滤，"-" 屏蔽字段；复杂逻辑需实现 marshaljson 方法。

go语言框架结构体转换json方案 go语言数据序列【常用】

Go 默认不会把结构体字段名转成小写下划线风格，必须显式用 json tag 控制；不加 tag 就按 Go 字段名（大驼峰）输出，加了空 tag json:"" 会直接丢掉该字段。

结构体字段名怎么变成 user_name 这种格式

Go 的 json.Marshal 不做自动命名转换，它只认 struct tag。你写 ID int，默认输出就是 "ID": 1，不是 "id"，更不是 "user_id"。

要改成下划线风格，每个字段都得手动加 json tag：

type User struct {
    ID       int    `json:"id"`
    UserName string `json:"user_name"`
    Email    string `json:"email,omitempty"`
}

json:"id" 把 ID 映射为 id；json:"user_name" 把 UserName 映射为 user_name
omitempty 表示值为零值时跳过该字段：空字符串、0、nil 切片等都不会出现在输出里
字段名首字母必须大写（导出），否则 json 包根本看不到它——小写字段如 userName 或 email 会被忽略，输出为空对象 {}

嵌套结构体的 JSON tag 容易漏打

嵌套结构体不会继承外层的命名规则，每个字段都要单独标 json tag。比如 User 里有个 Address 字段，不能只给 User.Address 加 tag，而要进到 Address 结构体内部一个个标：

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

type Address struct {
    City  string `json:"city"`
    Zip   string `json:"zip_code"`
}

type User struct {
    ID      int     `json:"id"`
    Address Address `json:"address"`
}

如果 Address 里没打 tag，那它的字段就按 Go 名输出（City → "City"），不是你想要的 "city"
匿名字段（如 Address 直接嵌入）也不会自动包装进一个 key，而是把它的字段平铺到顶层，且仍依赖各自 tag
想让整个 Address 块变成 "shipping_address"？那就得在 User 里定义新字段：ShippingAddress Address `json:"shipping_address"`，而不是给匿名字段加别名 tag

切片、map 和敏感字段怎么控制输出

数组和 map 字段一样要打 tag，比如 Tags []string `json:"tags"`。但真正容易出问题的是字段过滤：

用 json:"-" 彻底屏蔽字段（如密码、内部 ID）：Password string `json:"-"`
omitempty 看的是“零值”，不是“空字符串”：对 int 是 0，对 bool 是 false，对指针是 nil——别误以为 "0" 或 "false" 字符串也会被跳过
如果要动态控制（比如只在特定角色下返回邮箱），就不能靠 tag，得实现 MarshalJSON 方法自己拼 JSON 字节

什么时候必须自己写 MarshalJSON

tag 解决不了所有问题。比如要扁平化嵌入字段、按固定顺序输出键、或把 []string 转成逗号分隔字符串，就得实现 MarshalJSON 方法：

func (u User) MarshalJSON() ([]byte, error) {
    type Alias User // 防止无限递归
    return json.Marshal(&struct {
        *Alias
        FullName string `json:"full_name"`
    }{
        Alias:    (*Alias)(&u),
        FullName: u.FirstName + " " + u.LastName,
    })
}