Go 语言标准库中encoding/json模块详细功能介绍与示例

Go语言的encoding/json模块提供了丰富的JSON编解码方法,以下是对各主要方法及结构体标签的详细说明和示例:


1. json.Marshal

将Go对象转换为JSON字节切片。

go 复制代码
type Person struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

p := Person{"Alice", 30}
data, err := json.Marshal(p)
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(data)) // 输出: {"name":"Alice","age":30}

2. json.Unmarshal

将JSON字节切片解析到Go对象。

go 复制代码
jsonStr := `{"name":"Bob","age":25}`
var p Person
err := json.Unmarshal([]byte(jsonStr), &p)
if err != nil {
    log.Fatal(err)
}
fmt.Println(p.Name) // 输出: Bob

3. json.MarshalIndent

生成带缩进格式的JSON。

go 复制代码
data, err := json.MarshalIndent(p, "", "  ")
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(data))
// 输出:
// {
//   "name": "Alice",
//   "age": 30
// }

4. json.NewEncoderEncoder.Encode

将JSON写入io.Writer(如文件或HTTP响应)。

go 复制代码
file, _ := os.Create("person.json")
encoder := json.NewEncoder(file)
err := encoder.Encode(p)
if err != nil {
    log.Fatal(err)
}
// 文件内容: {"name":"Alice","age":30}

5. json.NewDecoderDecoder.Decode

io.Reader(如文件或HTTP请求)读取并解析JSON。

go 复制代码
file, _ := os.Open("person.json")
var p Person
decoder := json.NewDecoder(file)
err := decoder.Decode(&p)
if err != nil {
    log.Fatal(err)
}
fmt.Println(p.Name) // 输出: Alice

6. Encoder.SetEscapeHTML

控制是否转义HTML字符(默认true)。

go 复制代码
encoder := json.NewEncoder(os.Stdout)
encoder.SetEscapeHTML(false)
encoder.Encode("<div>test</div>")
// 输出: "<div>test</div>"

7. Decoder.DisallowUnknownFields

禁止JSON中出现未知字段。

go 复制代码
jsonStr := `{"name":"Charlie","age":35,"gender":"male"}`
decoder := json.NewDecoder(strings.NewReader(jsonStr))
decoder.DisallowUnknownFields()
err := decoder.Decode(&p) // 报错: json: unknown field "gender"

8. Decoder.UseNumber

将数字解析为json.Number类型(避免精度丢失)。

go 复制代码
jsonStr := `{"age": 30}`
decoder := json.NewDecoder(strings.NewReader(jsonStr))
decoder.UseNumber()
var result map[string]interface{}
decoder.Decode(&result)
age, _ := result["age"].(json.Number).Int64()
fmt.Println(age) // 输出: 30

9. json.Valid

验证字节切片是否为合法JSON。

go 复制代码
data := []byte(`{"name":"Alice"}`)
valid := json.Valid(data)
fmt.Println(valid) // 输出: true

10. json.RawMessage

延迟解析部分JSON数据。

go 复制代码
type RawExample struct {
    Data json.RawMessage `json:"data"`
}
rawJson := `{"data": {"key": "value"}}`
var re RawExample
json.Unmarshal([]byte(rawJson), &re)
// re.Data 保持原始JSON: {"key":"value"}

结构体标签(Struct Tags)

控制JSON字段名称、忽略字段等。

go 复制代码
type User struct {
    Name    string `json:"username"`          // 字段重命名为username
    Age     int    `json:"age,omitempty"`     // 如果Age为0,则省略
    Secret  string `json:"-"`                 // 忽略该字段
}

u := User{Name: "Dave", Age: 0}
data, _ := json.Marshal(u)
fmt.Println(string(data)) // 输出: {"username":"Dave"}

总结

  • 常用方法MarshalUnmarshalMarshalIndentNewEncoderNewDecoder
  • 流处理 :使用EncoderDecoder处理网络或文件流。
  • 高级控制SetEscapeHTMLDisallowUnknownFieldsUseNumber
  • 验证与延迟解析ValidRawMessage
  • 字段定制:通过结构体标签灵活控制JSON映射。

这些方法覆盖了JSON处理的大部分场景,从简单序列化到复杂的流式处理均可应对。

相关推荐
Livingbody17 分钟前
【心理咨询师数字孪生对话数据集】标准化为 ShareGPT OpenAI 格式
后端
Entropy-Lee24 分钟前
JavaScript 语句和函数
开发语言·前端·javascript
ok06033 分钟前
C++对象访问有访问权限是不是在ide里有效
开发语言·c++·ide
衍生星球36 分钟前
JSP 程序设计之 Web 技术基础
java·开发语言·jsp
程序员编程指南1 小时前
Qt 开发自动化测试框架搭建
c语言·开发语言·c++·qt
三小尛1 小时前
C++赋值运算符重载
开发语言·c++
籍籍川草1 小时前
JVM指针压缩的那些事
java·开发语言·jvm
小徐不徐说1 小时前
C++ 模板与 STL 基础入门:从泛型编程到实战工具集
开发语言·数据结构·c++·qt·面试
艾莉丝努力练剑1 小时前
【C/C++】类和对象(上):(一)类和结构体,命名规范——两大规范,新的作用域——类域
java·c语言·开发语言·c++·学习·算法
AQin10122 小时前
IP 🆚 MAC,你分得清吗?
后端·网络协议