在 Golang 的 JSON 序列化场景中，指针的使用可以让你更加灵活地表达字段的存在与否。本文围绕 Golang 指针在 JSON 序列化中的技巧与实战详解，聚焦指针字段在 json.Marshal 与 json.Unmarshal 时的行为、控制输出的技巧，以及自定义序列化的实战做法。
1. 基本行为：指针字段在 JSON 序列化中的默认表现
指针字段的编码规则与 nil 值的处理
要点1：Go 的 json.Marshal 会把指针字段在为 nil 时编码为 null；如果字段带有 omitempty，且指针为 nil，则该字段会被省略。这是序列化中处理“缺失”信息的核心机制。
要点2：当指针非 nil 时，序列化会输出指针所指向的实际值，并且不会因为值为零值而自动省略，除非你对字段应用了 omitempty 且满足省略条件。
package mainimport ("encoding/json""fmt"
)type User struct {Name *string `json:"name,omitempty"`Age *int `json:"age,omitempty"`
}func main() {// 全 nil 的情况var u1 Userb1, _ := json.Marshal(u1)fmt.Println(string(b1)) // 输出: {}// 非 nil 指针，输出实际值n := "Alice"a := 30u2 := User{Name: &n, Age: &a}b2, _ := json.Marshal(u2)fmt.Println(string(b2)) // 输出: {"name":"Alice","age":30}
}
小结：nil 指针时字段会被省略或输出为 null，取决于是否使用了 omitempty；非 nil 指针会按指针所指向的值进行编码，这为后续的可选字段设计提供了基础能力。
2. 与 omitempty 的组合：如何实现字段的可选性
可选字段的行为差异与示例
要点1：使用 omitempty 时，只有指针为 nil 的字段才会被省略，非 nil 的指针即使指向零值也会被编码，例如指针指向 "" 或 0 时仍会输出对应的字面量。
要点2：如果你需要在字段缺失时省略，且不希望输出空字符串、0 等零值，你需要通过将字段设为指针并结合自定义序列化来实现更细粒度的控制。
package mainimport ("encoding/json""fmt"
)type Product struct {Description *string `json:"description,omitempty"`Price *int `json:"price,omitempty"`
}func main() {// Description 为 nil 时省略；Price 为 nil 时也省略p := Product{}out, _ := json.Marshal(p)fmt.Println(string(out)) // 输出: {}// 描述存在但为空字符串，仍会输出 "description": ""desc := ""p2 := Product{Description: &desc}out2, _ := json.Marshal(p2)fmt.Println(string(out2)) // 输出: {"description":""}
}
要点3：如果你需要“缺失即省略、存在但为空也省略”的行为，需结合自定义序列化或使用自定义字段类型来实现，否则 omitempty 只对 nil 指针起作用。理解这一点是实现更复杂序列化行为的关键。
3. 自定义序列化：MarshalJSON 与 UnmarshalJSON 的应用场景
通过实现 MarshalJSON 控制指针字段输出形式
要点1：通过实现 MarshalJSON，你可以对输出字段进行任意控制，例如只输出非 nil 的字段，或将 nil 指针映射为特定文本。
要点2：自定义序列化在与前端约定严格字段样式、或者需要跨版本兼容时特别有用。
package mainimport ("encoding/json""fmt"
)type Person struct {ID *int `json:"id"`Name *string `json:"name"`
}func (p Person) MarshalJSON() ([]byte, error) {type Alias Personm := map[string]interface{}{}if p.ID != nil { m["id"] = *p.ID }if p.Name != nil { m["name"] = *p.Name }return json.Marshal(m)
}func main() {id := 101name := "Bob"p := Person{ID: &id, Name: &name}b, _ := json.Marshal(p)fmt.Println(string(b)) // 输出: {"id":101,"name":"Bob"}// 全 nil 时输出空对象p2 := Person{}b2, _ := json.Marshal(p2)fmt.Println(string(b2)) // 输出: {}
}
要点3：你也可以结合 UnmarshalJSON 实现双向自定义解析，例如将外部字段映射到指针类型、保留缺失信息等。
package mainimport ("encoding/json""fmt"
)type Item struct {Value *int `json:"value"`
}func (i *Item) UnmarshalJSON(data []byte) error {var tmp struct {Value *int `json:"value"`}if err := json.Unmarshal(data, &tmp); err != nil {return err}i.Value = tmp.Valuereturn nil
}func main() {data := []byte(`{"value":42}`)var it Item_ = json.Unmarshal(data, &it)fmt.Println(it.Value) // 输出: pointer to 42
}
要点4：在复杂对象或与第三方 API 交互时，自定义序列化是实现高可控输出的强大工具，尤其当你需要区分“字段不存在”和“字段为 null/空”的语义时。
通过以上技巧，你可以在 Golang 的 JSON 序列化场景中灵活运用指针：nil 指针的省略 vs. 非 nil 指针的值输出、omitempty 的精确行为、以及 自定义序列化逻辑，从而在实际项目中实现更稳定、可维护的 JSON 结构。以上内容聚焦的核心议题正是 Golang 指针在 JSON 序列化中的技巧与实战详解。
