JSON Marshal 库

Hertz 默认集成并使用 Sonic 用于序列化 ctx.JSON 接口,以及反序列化 binding 包中的请求。Sonic 是一款超高性能 golang json 库,详情参考 Sonic README

开启 Sonic 需要满足以下条件:

  • Go 1.16 以上
  • Linux / darwin OS / Windows
  • Amd64 CPU with AVX instruction set

当上述条件不能满足时,Sonic 会自动 fallback 到 golang 的 encoding/json 库。

自定义 JSON Marshall 库

如果 Sonic 不能够满足您的需求,你可以使用以下方式自定义 json marshal 库的实现:

import (
    "encoding/json"

    "github.com/bytedance/go-tagexpr/v2/binding"
    "github.com/cloudwego/hertz/pkg/app/server/render"
)
func main() {
    // Render
    render.ResetJSONMarshal(json.Marshal)

    // Binding
    binding.ResetJSONUnmarshaler(json.Unmarshal)
}

条件编译

Hertz 支持条件编译来控制实际使用的 json 库,你可以通过 -tags stdjson 来选择使用标准库。

go build -tags stdjson 

Sonic 相关问题

若出现与 Sonic 相关的问题,可参考 Sonic README 或提 issue 解决。


最后修改 August 3, 2023 : docs: delete part content (c7a91e7)