Go 1.25 在 8 月份如期而至，这次更新的新特性简直多到让人眼花缭乱，再一次把 Go 的性能天花板往上抬了一大截。

先上版本号镇楼：

> go version
go version go1.25.0 windows/amd64

众多更新的库中，最值得开发者欢呼的当属 json v2—— 这个每天都要打交道的组件，终于迎来了脱胎换骨的升级！

为啥需要 json v2？历史遗留问题该解决了

Go 标准库的 encoding/json（也就是 v1）从 Go 1.0 用到现在，算是功勋老将了。

但随着业务场景越来越复杂，它的短板也越来越扎眼：

但随着应用场景的复杂化，其局限性日益明显：

性能瓶颈：反射机制就像个慢郎中，大数据量序列化时能急死人

内存占用高：临时对象疯狂分配，GC 压力大到让运维同学头秃

功能缺失：流式处理聊胜于无，想扩展自定义逻辑简直反人类

Go 开发团队显然也收到了无数开发者的吐槽，于是在 Go 1.25 直接重构出 encoding/json/v2，从根上解决问题！

v1 vs v2 核心差异：一张表看懂强在哪

直接上干货，看看 v2 到底强在哪：

* 想深入了解标准差异的同学，可以点击对应的 RFC 链接查看细节

代码怎么写？新旧写法直观对比

v1 传统写法（大家都熟）

import "encoding/json"

type User struct {    
  Name string `json:"name"`    
  Age  int    `json:"age"`
}

func main() {    
  u := User{Name: "Xiaoming", Age: 18}    
  data, _ := json.Marshal(u)    
  fmt.Println(string(data)) // {"name":"Xiaoming","age":18}
}

v2 新写法（骚操作拉满）

import "encoding/json/v2"

type User struct {    
  Name string `json:"name"`    
  Age  int    `json:"age"`
}

func main() {    

  u := User{Name: "Xiaoming", Age: 18}
  
  // 方法1：兼容模式（直接替换v1无压力）  
  data, _ := v2.Marshal(u)  
  
  // 方法2：高性能模式（自定义配置拉满）   
  data, _ := v2.MarshalOptions{
                 Optimize: true， // 性能开关（必开！）
                 Indent:   "  ",  // 格式化输出（调试友好）
                 AllowDuplicateFields: false, // 禁止重复字段（默认就该这样）
                 Sort:    true,  // 字段按字典序排列（API文档专用）
                 EscapeHTML: false, // 不转义HTML字符（按需开启）
             }.Marshal(u)
  
  fmt.Println(string(data))

格式化输出的效果长这样（强迫症表示极度舒适）：

{
  age: 18, 
  name: "Xiaoming"
}

这些新标签能省掉你几百行代码

v2 新增的 json 标签简直是 productivity 神器，挑几个常用的说说：

• 深度空值检查

  type User struct {    
    // 递归检查结构体内部字段是否为空   
    Profile Profile `json:"profile, omitempty=deep"`
    // 用自定义逻辑判断空值（比如time.Time的IsZero）   
    LastActive *time.Time `json:"lastActive, omitempty=isZero"`
  }
  

再也不用手动写一堆判空逻辑了！

• 自动类型转换

  type Data struct {    
    // 字符串类型的数字自动转int（对接旧系统神器） 
    ID string `json:"id,autoint"`
    // 自动识别多种时间格式（再也不用纠结时区问题）   
    Timestamp time.Time `json:"ts,timeformat:auto"`
  }

• 嵌入式结构体

  type Base struct {    
    ID string `json:"id"`
  }
  type User struct {    
    Base `json:",inline"` // 内联展开（类似继承效果）   
    Address struct {        
      City string `json:"city,flatten"`  // 扁平化嵌套字段
    } `json:"-"`
  }

输出直接变成：{"id": "1", "city": "Xian"}，少写 N 个字段映射！

• 字段排序 & 敏感数据处理

  type Document struct {    
    Title string `json:"title,order:1"`  // 按数字指定顺序 
    Body  string `json:"body,order:2"`    
    ID    string `json:"id,order:0"`     // 数字越小越靠前
  }

• 去除敏感数据

  type Account struct {    
    Password string `json:"password,secure"` // 日志自动脱敏（*号替换） 
    Token string `json:"token,writeonly"`    // 反序列化时忽略（只写字段）
  }

流式处理：大JSON文件的救星

处理几 GB 的 JSON 文件时，直接 Unmarshal 会把内存撑爆。v2 的流式处理能一块一块读，内存占用稳如老狗。

package main

import (
  "fmt"
  "strings"
  "encoding/json/v2"
)

func main() {
  jsonData := `[{"name":"a","age":1},{"name":"b","age":2},{"name":"c","age":3}]`
  decoder := json.NewDecoder(strings.NewReader(jsonData))
  
  // 先读数组开头的[
  t, _ := decoder.Token()
  if delim, ok := t.(json.Delim); !ok || delim != '[' {
    panic("不是数组格式啊兄弟")
  }
  
  // 遍历数组元素
  for decoder.More() {
    // 读对象开头的{
    t, _ := decoder.Token()
    if delim, ok := t.(json.Delim); !ok || delim != '{' {
      panic("不是对象格式啊兄弟")
    }
    
    var name string
    var age int
    // 读取对象里的字段
    for decoder.More() {
      key, _ := decoder.Token()
      switch key.(string) {
        case "name":
          decoder.Decode(&name)
        case "age":
          decoder.Decode(&age)
        default:
          decoder.Skip() // 跳过不需要的字段
      }
    }
    
    // 读完对象的}
    decoder.Token()
    fmt.Printf("Name: %s, Age: %d\n", name, age)
  }
  
  // 读完数组的]
  decoder.Token()
}

虽然代码看起来有点多，但相比内存溢出崩溃，这点麻烦算啥？后续估计会有第三方库封装得更简洁，先 mark 住这个用法。

最后说句大实话

Go 1.25 的 json v2 不是小打小闹的优化，而是彻底重写的引擎。

从反射换成代码生成 + JIT 的思路，直接让 Go 的 JSON 处理性能跻身第一梯队。

建议新项目直接上 v2，老项目可以先把核心路径（比如 API 序列化、大数据解析）迁过来试试水

提升的性能和减少的内存占用，绝对值得你花半天时间改代码。

这波更新，我给 Go 团队点个大大的赞！