【Go】EasyJson使用

2026/8/15 20:35:22 拓冰建站浏览量

EasyJson是Go语言中对象序列化与反序列化的工具，类似Java中的fastjson和Jackson，能快速对对象进行序列化和反序列化，本次介绍一下使用方法。

版本信息：

go1.20.2

1，获取源码

# go get
go get -u github.com/mailru/easyjson/

2，安装

# install
go install github.com/mailru/easyjson/

如果失败，可以将项目克隆到$GOPATH/src/mailru 目录下并将包名改为easyjson,然后进入easyjson包下的easyjson目录，运行go build 命令，再将生成的二进制文件放到$GOPATH/bin目录下并改名为easyjson

也可以将二进制文件加到环境变量里。

我的go build路径如下

/home/easton/go/src/github.com/mailru/easyjson/easyjson

3，定义model文件

easyjson需要通过model文件生成对应的序列化和反序列化方法

项目结构：

test
├── src
│   └── easyjson
│       ├── easyjson_test.go
│       ├── struct_def.go
│       └── struct_def_easyjson.go

模型文件定义struct_def.go

package easyjsontype BasicInfo struct {Name string `json:"name"`Age  int    `json:"age"`
}
type JobInfo struct {Skills []string `json:"skills"`
}
type Employee struct {BasicInfo BasicInfo `json:"basic_info"`JobInfo   JobInfo   `json:"job_info"`
}

4，执行命令生成工具文件

cd test/src/easyjson
easyjson -all struct_def.go

生产struct_def_easyjson.go，内容如下：

// MarshalJSON supports json.Marshaler interface
func (v Employee) MarshalJSON() ([]byte, error) {w := jwriter.Writer{}easyjson7c82d03EncodeGoproject01Day33Easyjson1(&w, v)return w.Buffer.BuildBytes(), w.Error
}// MarshalEasyJSON supports easyjson.Marshaler interface
func (v Employee) MarshalEasyJSON(w *jwriter.Writer) {easyjson7c82d03EncodeGoproject01Day33Easyjson1(w, v)
}// UnmarshalJSON supports json.Unmarshaler interface
func (v *Employee) UnmarshalJSON(data []byte) error {r := jlexer.Lexer{Data: data}easyjson7c82d03DecodeGoproject01Day33Easyjson1(&r, v)return r.Error()
}

5，测试

创建easyjson_test.go,编写单元测试和性能测试方法如下：

package easyjsonimport ("encoding/json""testing"
)var jsonStr = `{"basic_info":{"name":"Mike","age":30},"job_info":{"skills":["Java","Go","C"]}
}`func TestEasyJson(t *testing.T) {e := Employee{}err := e.UnmarshalJSON([]byte(jsonStr))if err != nil {t.Fatal("json to obj error", err.Error())}t.Log(e)//对象转化为jsonbytes, err1 := e.MarshalJSON()if err1 != nil {t.Fatal("object to json error", err1.Error())}t.Log(string(bytes))
}func BenchmarkEasyJson(b *testing.B) {b.ResetTimer()e := Employee{}for i := 0; i < b.N; i++ {err := e.UnmarshalJSON([]byte(jsonStr))if err != nil {b.Error("EasyJson: json to object error", err.Error())}_, err1 := e.MarshalJSON()if err1 != nil {b.Error("EasyJson: object to json error", err1.Error())}}}func BenchmarkEmbeddedJson(b *testing.B) {b.ResetTimer()e := Employee{}for i := 0; i < b.N; i++ {err := json.Unmarshal([]byte(jsonStr), &e)if err != nil {b.Error("Embedded: json to object error", err.Error())}//obj to json_, err1 := json.Marshal(e)if err1 != nil {b.Error("Embedded: object to json error", err1.Error())}}
}

测试Embedded json 与EasyJson性能对比

cd test/src/easyjson/
go test -bench=. benchmem

性能测试结果如下：

pkg: test/easyjson
BenchmarkEasyJson-10        	 2773292	       425.5 ns/op	     252 B/op	       5 allocs/op
BenchmarkEmbeddedJson-10    	  752252	      1552 ns/op	     584 B/op	      11 allocs/op
PASS
ok  	test/easyjson	2.921s

EasyJson官网地址

Github地址：https://github.com/mailru/easyjson

建站实战干货

【Go】EasyJson使用