Sujets Go importants

Go JSON: Marshal and Unmarshal

Turn structs into JSON and JSON into structs, with struct tags to choose the field names.

  • Intermédiaire
  • 3 min de lecture
  • 1 exemple exécutable
Ce que vous allez apprendre
  • json.Marshal
  • json.Unmarshal
  • Struct tags and omitempty
Round trip
  1. 1Product{...}a struct
  2. 2json.Marshal{"name":"Go Book",...}
  3. 3json.Unmarshalback to a struct

Structs to JSON and back

The encoding/json package converts Go values to JSON text and JSON text back to Go values. Struct tags choose the names used in the JSON.

Marshal turns the struct into JSON bytes, using the names from the json tags. Unmarshal fills a struct from JSON and needs a pointer so it can change the value. omitempty leaves a field out when it is empty, and a missing field keeps its zero value.

Points clés

  1. Tags choose the names used in JSON.
  2. Unmarshal needs a pointer.
  3. omitempty leaves out empty fields.

Exemple Go exécutable

Go
Exécuter le code →
main.go
package main

import (
	"encoding/json"
	"fmt"
)

type Product struct {
	Name  string   `json:"name"`
	Price float64  `json:"price"`
	Tags  []string `json:"tags,omitempty"`
}

func main() {
	book := Product{Name: "Go Book", Price: 12.5, Tags: []string{"go", "learning"}}
	data, err := json.Marshal(book)
	if err != nil {
		fmt.Println("error:", err)
		return
	}
	fmt.Println(string(data))

	var parsed Product
	input := `{"name":"Pen","price":1.25}`
	if err := json.Unmarshal([]byte(input), &parsed); err != nil {
		fmt.Println("error:", err)
		return
	}
	fmt.Printf("%s costs %.2f, tags: %d\n", parsed.Name, parsed.Price, len(parsed.Tags))
}
Obtenir un bouton Run pour cet exemple Résultat de l'exécution
{"name":"Go Book","price":12.5,"tags":["go","learning"]}
Pen costs 1.25, tags: 0

S'entraîner

Ouvrez l'exemple dans le compilateur en ligne, modifiez une valeur ou ajoutez une ligne, et devinez la sortie avant de l'exécuter. Cassez ensuite le code exprès et lisez le message du compilateur.

Leçon terminée ?

Marquez-la comme apprise pour suivre votre progression.

Suivante : Sorting Slices →

S'entraîner avec un défi

Utilisez le contenu de cette leçon pour résoudre un vrai problème. Chaque défi s'exécute dans le navigateur, avec des tests instantanés et une revue par l'IA.

Tous les défis