Go JSON v2 來了！！！
說實話，現有的 encoding/json 包雖然能用，但是各種限制和性能問題確實讓人頭疼，特別是處理大量數據的時候，那速度真的是...很容易擺爛。
新版本 Go1.25 有一個很多 Gopher 期待已久的新標準庫——JSON v2[1]（實驗階段），能夠較好的解決這個煩惱。
圖片
為什么需要 JSON v2？
第一：現有的 encoding/json 包確實有不少歷史包袱。從 Go 1.0 到現在，這個包基本沒怎么大改過，很多設計上的問題一直拖著。比如說：
Encoder/Decoder的 API 設計不夠靈活。- 自定義序列化的方式太單一。
- 性能問題，特別是反序列化的性能。
- 一些默認行為不太合理。
第二：社區呼聲很高。你去看看 GitHub 上的 issue，關于 JSON 包的吐槽那是一抓一大把。大家都希望有個更好用、更快的 JSON 包。
但很無奈的是，Go 的兼容性承諾在那擺著，不能隨便改現有的 API。
所以 Go 團隊這次的思路是：搞個 v2，先用 GOEXPERIMENT 來控制。
JSON v2 到底改了啥？
接下來我們看下 JSON v2 的核心變化。這個新版本不是簡單的修修補補。
是從 API 設計到內部實現的全面重構。所以搞了很久才釋出。
新的 API 設計
最明顯的變化就是 API：
圖片
以下是一些要點介紹。
更直觀的 IO 操作
原來我們要寫入 io.Writer 或者從 io.Reader 讀取，得用 Encoder 和 Decoder：
// v1 的寫法
alice := Person{Name: "Alice", Age: 25}
out := new(strings.Builder)
enc := json.NewEncoder(out)
enc.Encode(alice)
fmt.Println(out.String())現在 v2 直接提供了 MarshalWrite 和 UnmarshalRead：
// v2 的寫法
alice := Person{Name: "Alice", Age: 25}
out := new(strings.Builder)
json.MarshalWrite(out, alice)
fmt.Println(out.String())簡單來說，就是少了一層中間商賺差價。
不過這里有幾個點需要注意：
MarshalWrite不會添加換行符，而老的Encoder.Encode會。UnmarshalRead會讀取整個 reader 直到 EOF，而老的Decoder.Decode只讀下一個 JSON 值。
如果你需要流式處理，v2 也提供了新的方案。Encoder 和 Decoder 被移到了 jsontext 包，配合 MarshalEncode 和 UnmarshalDecode 使用：
// 流式編碼
people := []Person{
{Name: "Alice", Age: 25},
{Name: "Bob", Age: 30},
}
out := new(strings.Builder)
enc := jsontext.NewEncoder(out)
for _, p := range people {
json.MarshalEncode(enc, p)
}強大的配置選項
這個真的是 v2 的一大亮點。再也不用為了改個格式而頭疼了。
alice := Person{Name: "Alice", Age: 25}
b, _ := json.Marshal(
alice,
json.OmitZeroStructFields(true), // 省略零值字段
json.StringifyNumbers(true), // 數字轉字符串
jsontext.WithIndent(" "), // 縮進格式化
)
fmt.Println(string(b))還可以用 JoinOptions 組合選項：
opts := json.JoinOptions(
jsontext.SpaceAfterColon(true),
jsontext.SpaceAfterComma(true),
)
b, _ := json.Marshal(alice, opts)增強的標簽支持
v2 不僅支持原有的標簽，還新增了幾個很實用的：
type Person struct {
Name string `json:"name"`
BirthDate time.Time `json:"birth_date,format:DateOnly"` // 格式化日期
Address `json:",inline"` // 內聯字段
}
type Address struct {
Street string `json:"street"`
City string `json:"city"`
}inline 標簽可以把嵌套對象的字段提升到父對象：
alice := Person{
Name: "Alice",
BirthDate: time.Date(2001, 7, 15, 12, 35, 43, 0, time.UTC),
Address: Address{
Street: "123 Main St",
City: "Wonderland",
},
}
// 輸出會把 street 和 city 直接放在 Person 對象里還有個 unknown 標簽，可以收集所有未知字段：
type Person struct {
Name string `json:"name"`
Data map[string]any `json:",unknown"` // 收集未知字段
}靈活的自定義序列化
這個功能真的讓我眼前一亮。以前要自定義序列化，必須給類型實現 MarshalJSON 方法。
現在你可以用 MarshalFunc 隨時定義：
// 把 bool 序列化成 ? 或 ?
boolMarshaler := json.MarshalFunc(
func(val bool) ([]byte, error) {
if val {
return []byte(`"?"`), nil
}
return []byte(`"?"`), nil
},
)
val := true
data, err := json.Marshal(val, json.WithMarshalers(boolMarshaler))
fmt.Println(string(data)) // "?"還可以組合多個自定義序列化器：
// 可以同時處理 bool 和 bool-like 字符串
strMarshaler := json.MarshalToFunc(
func(enc *jsontext.Encoder, val string) error {
if val == "on" || val == "true" {
return enc.WriteToken(jsontext.String("?"))
}
if val == "off" || val == "false" {
return enc.WriteToken(jsontext.String("?"))
}
return json.SkipFunc // 跳過，使用默認序列化
},
)
marshalers := json.JoinMarshalers(boolMarshaler, strMarshaler)默認行為的改進
v2 修正了一些反直覺的默認行為：
- nil slice 現在序列化成
[]而不是null。 - nil map 現在序列化成
{}而不是null。 - 字節數組默認編碼為 base64 字符串，而不是數字數組。
- 字段名匹配默認區分大小寫。
例子如下：
type Person struct {
Name string
Hobbies []string
Skills map[string]int
Secret [5]byte
}
alice := Person{
Name: "Alice",
Secret: [5]byte{1, 2, 3, 4, 5},
}
// v2 輸出：
// {
// "Name": "Alice",
// "Hobbies": [],
// "Skills": {},
// "Secret": "AQIDBAU="
// }如果想要 v1 的行為，可以通過選項配置：
b, _ := json.Marshal(
alice,
json.FormatNilMapAsNull(true),
json.FormatNilSliceAsNull(true),
)JSON v2 性能大幅提高
目前看來，根據官方的 benchmark[2] 數據，反序列化性能提升了 2.7 到 10.2 倍，這個提升幅度確實很可觀。
圖片
特別是對于那些需要處理大量 JSON 數據的項目，比如微服務之間的通信、日志處理等場景，這個性能提升是實打實的。
如何嘗鮮？
我們來看下怎么體驗 JSON v2。目前 JSON v2 還在實驗階段。
圖片
需要設置環境變量開啟：
GOEXPERIMENT=jsonv2 go build your_project當設置了這個標志后：
- 新的
encoding/json/v2和encoding/json/jsontext包會生效。 - 現有的
encoding/json包會使用 v2 的實現。 - 可以使用 v2 提案中的新 API。
總結
從目前的設計來看，JSON v2 確實解決了現有 encoding/json 包的很多痛點：性能大幅提升、API 更加靈活、支持更多自定義選項。雖然學習成本有一定增加，但是帶來的收益是值得的。
如果能在后續版本轉正（正式落地），相信會讓很多 Gopher 的開發體驗有質的提升。畢竟誰不想告別那些繁瑣的 JSON 處理代碼呢？
參考資料
[1] JSON v2: https://github.com/golang/go/issues/71845
[2] benchmark: https://github.com/go-json-experiment/jsonbench
