本文介绍如何在 Go 的 JSON 序列化中正确表示缺失字段为 null（而非空字符串），核心方案是使用 *string 等指针类型，利用 encoding/json 包对 nil 指针的原生支持。
本文介绍如何在 go 的 json 序列化中正确表示缺失字段为 `null`（而非空字符串），核心方案是使用 `*string` 等指针类型，利用 `encoding/json` 包对 `nil` 指针的原生支持。
在 Go 中，string 类型的零值是空字符串 ""，而许多外部 API（如 RESTful 服务、TypeScript 前端或严格模式的数据库接口）要求“未提供值”必须显式表达为 JSON null，而非 " " 或 ""。若直接使用 string 字段，即使业务逻辑中未设置该字段，序列化后仍会输出 {"first_name": ""} —— 这与语义上的“字段不存在/未提供”相悖。
*推荐方案：使用指针类型（如 `string`）**
Go 标准库 encoding/json 明确规定：
Pointer values encode as the value pointed to. A nil pointer encodes as the null JSON object.
（指针值编码为其所指向的值；nil 指针编码为 JSON 的 null。）
因此，只需将字段声明为 *string，并在初始化时保持为 nil，即可自然达成目标：
type Student struct {
FirstName *string `json:"first_name"`
MiddleName *string `json:"middle_name"`
LastName *string `json:"last_name"`
}
// 示例：仅设置 FirstName，其余字段留空（nil）
firstName := "Alice"
s := Student{
FirstName: &firstName,
// MiddleName 和 LastName 保持 nil → 序列化为 null
}
data, _ := json.Marshal(s)
fmt.Println(string(data))
// 输出：{"first_name":"Alice","middle_name":null,"last_name":null}✅ 优势显著：
- 语义清晰：nil 明确表示“值未提供”，非空指针表示“值明确为空字符串”（此时需手动赋值 &""）；
- 零依赖：无需第三方库或自定义 MarshalJSON 方法；
- 兼容性好：反序列化时，JSON 中的 null 会自动映射为 nil 指针，"value" 自动解包为 *string 指向新字符串；
- 可扩展：同理适用于 *int, *bool, *float64 等基本类型。
⚠️ 注意事项：
- 访问指针字段前务必判空，避免 panic：
if s.FirstName != nil { fmt.Println("First name:", *s.FirstName) } - 若需区分“未设置”和“显式设为空字符串”，此方案天然支持；但若业务中允许空字符串且需与 null 严格区分，则 *string 是必要且充分的设计。
- 不建议用 interface{}（如原问题所提）：它虽能容纳 nil，但失去类型安全，丧失编译期检查，且需手动处理序列化逻辑，易出错且性能更低。
总结：将 JSON 字段定义为 *string（或对应基本类型的指针）是 Go 生态中标准、高效、可维护的 null 表达方式。它精准契合 encoding/json 的设计契约，应作为处理可选字符串字段的默认实践。
