Go语言的encoding/json模块提供了丰富的JSON编解码方法，以下是对各主要方法及结构体标签的详细说明和示例：
jsonMarshal_4">1. json.Marshal
将Go对象转换为JSON字节切片。
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}
jsonUnmarshal_22">2. json.Unmarshal
将JSON字节切片解析到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
jsonMarshalIndent_36">3. json.MarshalIndent
生成带缩进格式的JSON。
data, err := json.MarshalIndent(p, "", " ")
if err != nil {log.Fatal(err)
}
fmt.Println(string(data))
// 输出:
// {
// "name": "Alice",
// "age": 30
// }
jsonNewEncoder__EncoderEncode_53">4. json.NewEncoder 与 Encoder.Encode
将JSON写入io.Writer（如文件或HTTP响应）。
file, _ := os.Create("person.json")
encoder := json.NewEncoder(file)
err := encoder.Encode(p)
if err != nil {log.Fatal(err)
}
// 文件内容: {"name":"Alice","age":30}
jsonNewDecoder__DecoderDecode_67">5. json.NewDecoder 与 Decoder.Decode
从io.Reader（如文件或HTTP请求）读取并解析JSON。
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）。
encoder := json.NewEncoder(os.Stdout)
encoder.SetEscapeHTML(false)
encoder.Encode("<div>test</div>")
// 输出: "<div>test</div>"
7. Decoder.DisallowUnknownFields
禁止JSON中出现未知字段。
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类型（避免精度丢失）。
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
jsonValid_118">9. json.Valid
验证字节切片是否为合法JSON。
data := []byte(`{"name":"Alice"}`)
valid := json.Valid(data)
fmt.Println(valid) // 输出: true
jsonRawMessage_128">10. json.RawMessage
延迟解析部分JSON数据。
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字段名称、忽略字段等。
type User struct {Name string `json:"username"` // 字段重命名为usernameAge 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"}
总结
- 常用方法：
Marshal、Unmarshal、MarshalIndent、NewEncoder、NewDecoder。 - 流处理：使用
Encoder和Decoder处理网络或文件流。 - 高级控制：
SetEscapeHTML、DisallowUnknownFields、UseNumber。 - 验证与延迟解析：
Valid和RawMessage。 - 字段定制：通过结构体标签灵活控制JSON映射。
这些方法覆盖了JSON处理的大部分场景，从简单序列化到复杂的流式处理均可应对。
