Tags JSON
Contrôler la sérialisation
Tags JSON est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.
Les balises JSON contrôlent la sérialisation
Le paquet encoding/json utilise les balises json pour déterminer les noms de clés et les règles lors de la conversion de structures en JSON et inversement.
Noms de champs par défaut
Sans balises, les clés JSON correspondent exactement aux noms des champs exportés, majuscules comprises.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string
Age int
}
func main() {
b, _ := json.Marshal(User{"Ann", 30})
fmt.Println(string(b))
}Renommer les clés
Une balise json modifie le nom de la clé dans la sortie. Ici, Name devient le nom en minuscules.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Age int "json:\"age\""
}
func main() {
b, _ := json.Marshal(User{"Ann", 30})
fmt.Println(string(b))
}L'option omitempty
Ajoutez ,omitempty pour exclure un champ de la sortie lorsqu'il contient sa valeur zéro (chaîne vide, 0, nil, etc.).
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Email string "json:\"email,omitempty\""
}
func main() {
b, _ := json.Marshal(User{Name: "Ann"})
fmt.Println(string(b))
}Ignorer un champ
Une balise - indique à l'encodeur d'ignorer complètement le champ, ce qui est utile pour des secrets tels que les mots de passe.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
Password string "json:\"-\""
}
func main() {
b, _ := json.Marshal(User{"Ann", "secret"})
fmt.Println(string(b))
}Désérialiser avec des balises
Les balises fonctionnent dans les deux sens. Lors du décodage du JSON, la balise indique au décodeur quelle clé JSON doit remplir quel champ.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
}
func main() {
var u User
json.Unmarshal([]byte("{\"name\":\"Bob\"}"), &u)
fmt.Println(u.Name)
}Correspondance insensible à la casse
Lors de la désérialisation, Go compare les clés JSON aux balises sans tenir compte de la casse en guise de solution de repli. Il reste toutefois plus sûr et plus clair de définir explicitement les balises.
Option string
L'option ,string encode un champ numérique ou booléen sous forme de chaîne JSON. Elle est utile pour les systèmes qui attendent des nombres entre guillemets.
package main
import (
"encoding/json"
"fmt"
)
type Item struct {
ID int "json:\"id,string\""
}
func main() {
b, _ := json.Marshal(Item{ID: 42})
fmt.Println(string(b))
}Combiner les options
Vous pouvez combiner un nom et des options : json:"email,omitempty". Le nom vient en premier, suivi des options séparées par des virgules.
Les champs non exportés sont ignorés
Seuls les champs exportés (commençant par une majuscule) sont sérialisés. Un champ en minuscules est invisible pour encoding/json, quelle que soit la balise qu'il porte.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
age int
}
func main() {
b, _ := json.Marshal(User{Name: "Ann", age: 30})
fmt.Println(string(b))
}Sortie mise en forme
json.MarshalIndent formate le JSON avec une indentation, ce qui est pratique pour obtenir des journaux lisibles tout en respectant les balises.
package main
import (
"encoding/json"
"fmt"
)
type User struct {
Name string "json:\"name\""
}
func main() {
b, _ := json.MarshalIndent(User{"Ann"}, "", " ")
fmt.Println(string(b))
}Vérification rapide
Que fait l’option ,omitempty dans une balise json ?
Récapitulatif
Les balises JSON contrôlent la sérialisation :
- Renommer les clés avec
json:"name" ,omitemptyignore les valeurs nulles-ignore un champ ;,stringmet les nombres entre guillemets- Seuls les champs exportés sont encodés
Apprends Go avec un tuteur IA — gratuit
Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.
- Cours
- 51
- Leçons
- 203
Questions Fréquemment Posées
La leçon « Tags JSON » est-elle gratuite ?
Oui — le texte complet de « Tags JSON » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Tags JSON » ?
Contrôler la sérialisation Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Go Academy ?
Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « Tags JSON » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?
Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.