Go 中忽略空嵌套结构体的 JSON 序列化方法

在 Go 的 json.Marshal 中，omitempty 标签无法跳过零值嵌套结构体（如 ColorGroup{}），因其本身不被视为“空值”；正确做法是将嵌套字段声明为指针类型（如 *ColorGroup），使未赋值时为 nil，从而被 omitempty 正确忽略。

在 Go 的 `json.Marshal` 中，`omitempty` 标签无法跳过零值嵌套结构体（如 `ColorGroup{}`），因其本身不被视为“空值”；正确做法是将嵌套字段声明为指针类型（如 `*ColorGroup`），使未赋值时为 `nil`，从而被 `omitempty` 正确忽略。

Go 的 encoding/json 包对“空值（empty value）”有明确定义：false、0、nil 指针或接口、长度为 0 的数组/切片/映射/字符串。但结构体的零值（例如 ColorGroup{}）不在该列表中——即使其所有字段均为零值，它仍会被序列化为 {"Name":"","Colors":null}，导致冗余输出。

要真正实现“完全省略未设置的嵌套结构体”，关键在于让该字段具备可区分的“未设置”状态。而 Go 中最自然的方式就是使用指针：

type ColorGroup struct {
    ID     int      `json:",omitempty"`
    Name   string   `json:",omitempty"`
    Colors []string `json:",omitempty"`
}

type Total struct {
    A *ColorGroup `json:",omitempty"` // ✅ 改为指针
    B string      `json:",omitempty"`
}

此时：

• 若 A 未初始化（即为 nil），json.Marshal 将彻底忽略该字段；
• 若显式赋值为 &ColorGroup{}，则会序列化其零值内容（此时 A 仍出现）；
• 若仅需部分字段（如 &ColorGroup{Name: "red"}），则只序列化非零且非空字段（依赖其内部 omitempty）。

完整示例：

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    group1 := Total{
        B: "abc",
    }
    b1, _ := json.Marshal(group1)
    fmt.Println(string(b1)) // {"B":"abc"}

    group2 := Total{
        A: &ColorGroup{Name: "Red"},
        B: "abc",
    }
    b2, _ := json.Marshal(group2)
    fmt.Println(string(b2)) // {"A":{"Name":"Red"},"B":"abc"}

    group3 := Total{
        A: &ColorGroup{},
        B: "abc",
    }
    b3, _ := json.Marshal(group3)
    fmt.Println(string(b3)) // {"A":{},"B":"abc"} ← 注意：A 仍存在（因指针非 nil）
}

⚠️ 重要注意事项：

• omitempty 对指针生效的前提是其值为 nil；一旦取地址（如 &ColorGroup{}），无论内容是否为空，该字段都会被序列化；
• 若业务逻辑中需支持“明确传入空结构体并跳过”，应配合自定义 MarshalJSON 方法，但多数场景下 nil 指针语义已足够清晰；
• 使用指针会略微增加内存分配（需堆上分配），但在 JSON 序列化场景中通常可忽略；若性能极度敏感，可考虑 sync.Pool 复用，但应先实测验证必要性。

总结：*让嵌套结构体可选且真正“可省略”的标准 Go 实践，就是将其字段声明为 `T并配合omitempty**——这既符合json` 包的设计约定，又保持代码简洁与语义明确。