Dans cet article
Qu'est-ce que YAML et pourquoi le valider
YAML, qui signifie YAML Ain't Markup Language, est un format de sérialisation de données convivial largement utilisé pour les fichiers de configuration, les pipelines CI/CD, l'infrastructure as code et l'échange de données. Sa syntaxe basée sur l'indentation le rend lisible mais le rend aussi très sensible aux erreurs d'espacement invisibles à l'oeil nu.
Valider le YAML avant le déploiement est essentiel car même un seul espace mal placé ou un mauvais niveau d'indentation peut faire analyser une configuration différemment de ce qui était prévu, ou provoquer un échec complet de l'analyse. Un fichier YAML cassé dans un manifest Kubernetes, une pile Docker Compose ou un workflow GitHub Actions peut faire tomber des services ou bloquer des déploiements.
Comment fonctionne le validateur YAML
Le validateur analyse votre entrée YAML et signale les erreurs de syntaxe avec des numéros de ligne et de colonne précis pour que vous puissiez corriger les problèmes instantanément.
- Collez votre YAML — entrez ou collez du contenu YAML de n'importe quelle taille et le validateur l'analyse immédiatement dans votre navigateur
- Voyez les détails de l'erreur — si le YAML est mal formé, le validateur met en évidence la ligne et la colonne exactes où l'analyseur a échoué, avec un message d'erreur clair
- Validez la structure — au-delà de la syntaxe, le validateur vérifie les clés en double, les types incorrects et d'autres problèmes structurels qui pourraient causer un comportement inattendu
- Formatez la sortie — le YAML valide est automatiquement formaté avec une indentation cohérente pour que vous puissiez copier une version propre dans votre projet
Essayez gratuitement — sans inscription
Ouvrir le validateur YAML →Erreurs YAML courantes et comment les corriger
La syntaxe YAML est trompeusement simple, et plusieurs schémas d'erreurs reviennent de façon récurrente dans les fichiers de configuration réels.
- Erreurs d'indentation — YAML utilise des espaces pour l'imbrication, et mélanger les tabulations avec les espaces ou utiliser des niveaux d'indentation incohérents est la source la plus courante d'échecs d'analyse
- Caractères spéciaux sans guillemets — les valeurs contenant des deux-points, des dièses ou des accolades doivent être entre guillemets pour empêcher l'analyseur de les interpréter comme de la syntaxe YAML
- Clés en double — YAML autorise les clés en double au même niveau mais seule la dernière valeur est conservée, ce qui écrase silencieusement les valeurs précédentes et cause des bugs difficiles à trouver
Questions fréquemment posées
Quelle est la différence entre YAML et JSON ?
YAML est un surensemble de JSON, ce qui signifie que tout document JSON valide est aussi du YAML valide. YAML ajoute des fonctionnalités comme les commentaires, les chaînes multilignes, les ancres et l'imbrication basée sur l'indentation qui le rendent plus lisible. JSON est plus strict et plus largement pris en charge par les API, tandis que YAML est préféré pour les fichiers de configuration où la lisibilité compte.
Puis-je utiliser des tabulations pour l'indentation en YAML ?
Non. La spécification YAML interdit explicitement les caractères de tabulation pour l'indentation. Vous devez utiliser des espaces, et le nombre d'espaces par niveau d'indentation doit être cohérent dans un document. La plupart des éditeurs peuvent être configurés pour insérer des espaces lorsque vous appuyez sur la touche Tab.
Le validateur prend-il en charge le YAML multi-documents ?
Oui. Les fichiers YAML peuvent contenir plusieurs documents séparés par un séparateur à trois tirets. Le validateur analyse chaque document indépendamment et signale les erreurs avec les numéros de ligne corrects relatifs au fichier complet.