JSON en YAML en Python
Du code Python à copier pour les deux sens, plus les options qui garantissent une sortie correcte.
JSONentrée
YAMLsortie
Chaque ligne de la sortie, en mise en forme par défaut, à côté du chemin de la valeur qu'elle contient. Cliquez sur une ligne pour copier le chemin.
Fonctionne entièrement dans votre navigateur: rien n'est envoyé. Des limites d'usage raisonnable s'appliquent (5 MB par entrée, nombre de conversions limité) pour éviter le spam et les robots.
JSON en YAML et retour avec PyYAML
PyYAML et le module standard json couvrent les deux sens. Ces options donnent la sortie la plus propre.
import json
import yaml # pip install pyyaml
with open("data.json", encoding="utf-8") as f:
data = json.load(f)
with open("data.yaml", "w", encoding="utf-8") as f:
yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True) import json
import yaml # pip install pyyaml
with open("data.yaml", encoding="utf-8") as f:
data = yaml.safe_load(f)
with open("data.json", "w", encoding="utf-8") as f:
# default=str turns dates and datetimes into strings
json.dump(data, f, indent=2, ensure_ascii=False, default=str) YAML multi-document et YAML 1.2
Lisez chaque document d'un fichier de style Kubernetes avec safe_load_all, ou utilisez ruamel.yaml pour les règles de YAML 1.2 et une indentation précise.
import json
import yaml
with open("manifests.yaml", encoding="utf-8") as f:
docs = list(yaml.safe_load_all(f)) # one item per --- document
print(json.dumps(docs, indent=2, default=str)) import json
import sys
from ruamel.yaml import YAML # pip install ruamel.yaml
yaml = YAML() # round-trip mode, YAML 1.2
yaml.indent(mapping=2, sequence=4, offset=2)
with open("data.json", encoding="utf-8") as f:
yaml.dump(json.load(f), sys.stdout) Commandes Python d'une ligne
Pratiques dans les scripts shell et la CI, tant que PyYAML est installé.
# JSON to YAML
python3 -c 'import sys, json, yaml; yaml.safe_dump(json.load(sys.stdin), sys.stdout, sort_keys=False, allow_unicode=True)' < data.json > data.yaml
# YAML to JSON
python3 -c 'import sys, json, yaml; json.dump(yaml.safe_load(sys.stdin), sys.stdout, indent=2, default=str)' < data.yaml > data.json Problèmes courants et solutions
Les surprises les plus fréquentes lors d'une conversion avec PyYAML. Choisissez-en une pour la voir avant et après la correction.
| Symptôme | Cause | Solution |
|---|---|---|
| Les clés sortent triées | safe_dump trie les clés par défaut. | Passez sort_keys=False. |
| é devient "\xE9" | Les caractères non ASCII sont échappés par défaut. | Passez allow_unicode=True. |
| yes / no / on / off | PyYAML suit YAML 1.1 : un no sans guillemets est chargé comme False. | Mettez-les entre guillemets dans le YAML, ou utilisez ruamel.yaml (YAML 1.2). |
| TypeError: datetime is not JSON serializable | safe_load transforme 2026-10-01 en objet date. | Passez default=str à json.dump. |
| load() sans Loader | PyYAML 6 exige un Loader pour yaml.load. | Utilisez yaml.safe_load, qui n'exécute jamais de code provenant du fichier. |
| Seul le premier document | safe_load lit un seul document. | Utilisez safe_load_all pour les fichiers séparés par ---. |
Autres outils
Convertisseurs, validateurs et guides pas à pas pour tous les endroits où JSON et YAML se croisent.
Convertisseurs
Formater et valider
Convertir par cas d'usage
- Kubernetes Transformez la sortie JSON de kubectl et les objets d'API en manifestes propres, prêts à appliquer.
- Docker Compose Créez un compose.yaml à partir de JSON, ports, environnement et volumes compris.
- GitHub Actions Écrivez des fichiers de workflow depuis JSON sans le piège on: / true.
- OpenAPI / Swagger Convertissez des spécifications OpenAPI 3 et Swagger 2.0 entre JSON et YAML.
- CloudFormation Convertissez des modèles AWS CloudFormation de JSON en YAML, fonctions intrinsèques comprises.
Guides code et ligne de commande
Questions fréquentes
Comment convertir du JSON en YAML en Python ?
Chargez le JSON avec json.load et écrivez-le avec yaml.safe_dump de PyYAML : yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True). Ces deux options conservent l'ordre de vos clés et les caractères non ASCII tels quels.
Comment convertir du YAML en JSON en Python ?
Lisez le fichier avec yaml.safe_load et écrivez-le avec json.dump(data, f, indent=2, default=str). Utilisez yaml.safe_load_all lorsque le fichier contient plusieurs documents séparés par ---.
Faut-il utiliser PyYAML ou ruamel.yaml ?
PyYAML est le choix le plus courant et suffit pour des conversions ponctuelles. ruamel.yaml implémente YAML 1.2, préserve les commentaires et l'ordre des clés lors de la modification d'un YAML existant, et offre un contrôle plus fin de l'indentation.
Pourquoi utiliser safe_load plutôt que load ?
yaml.load avec le loader complet peut construire des objets Python arbitraires à partir des balises du fichier, ce qui est dangereux pour des entrées non fiables. safe_load ne construit que des types simples : dicts, listes, chaînes, nombres, booléens, None et dates.
Puis-je convertir sans rien installer ?
Oui. Le convertisseur en haut de cette page s'exécute dans votre navigateur et ne nécessite ni Python, ni paquets, ni envoi de fichier. Collez du JSON ou du YAML et copiez le résultat.