Tutoriels pratiques Données et encodage

Comment convertir du JSON en CSV et inversement

Transformez une réponse d'API en CSV prêt pour un tableur et un CSV en JSON, avec des précisions sur le traitement des colonnes, des valeurs imbriquées et des types de données.

Dernière vérification :

AdSense Placeholder
Slot: header_reference_page
Sur cette page

Étapes

  1. Vérifier que le JSON est valide

    Collez-le d'abord dans le formateur JSON ou le validateur JSON. Une virgule ou un guillemet manquant est la cause la plus fréquente d'échec d'une conversion.

  2. Convertir le JSON en CSV

    Collez un tableau JSON d'objets dans le convertisseur JSON vers CSV et convertissez. La ligne d'en-tête est l'union des clés de tous les objets, dans l'ordre de première apparition, et un champ absent donne une cellule vide.

  3. Inspecter le CSV

    Par exemple, [{"id":1,"name":"Ana","tags":["a","b"]},{"id":2,"name":"Ben","city":"Lyon"}] devient un tableau avec les colonnes id,name,tags,city. Le tableau tags est stocké sous forme du texte ["a","b"] et la cellule tags de Ben est vide.

  4. Reconvertir le CSV en JSON

    Collez le CSV dans le convertisseur CSV vers JSON. La première ligne devient les clés et chaque ligne suivante un objet. Toutes les valeurs sont des chaînes, et une ligne courte est complétée par des chaînes vides.

  5. Valider la forme du résultat

    Si le JSON alimente une API ou une base de données, décrivez ce qu'il doit être et contrôlez-le avec le validateur de schéma JSON. Cela détecte les champs manquants et les valeurs qui devraient être des nombres.

  6. Ouvrir le CSV dans un tableur et contrôler par sondage

    Importez le fichier en texte UTF-8 et comparez quelques lignes avec la source. Attention aux identifiants à zéros initiaux et aux nombres longs qu'un tableur peut reformater à l'ouverture.

Ce dont vous avez besoin

Du JSON sous forme de tableau d'objets (un objet par ligne) ou un CSV avec une ligne d'en-tête. Les deux convertisseurs s'exécutent en local : vous pouvez donc utiliser de vraies données.

Ce que fait la conversion

Convertir ce JSON :

[{"id":1,"name":"Ana","tags":["a","b"]},{"id":2,"name":"Ben","city":"Lyon"}]

donne ce CSV :

id,name,tags,city
1,Ana,"[""a"",""b""]",
2,Ben,,Lyon

et reconvertir ce CSV donne :

[{"id": "1", "name": "Ana", "tags": "[\"a\",\"b\"]", "city": ""}, {"id": "2", "name": "Ben", "tags": "", "city": "Lyon"}]

Remarquez ce qui a changé à l'aller-retour : id est maintenant la chaîne "1", le tableau tags est devenu une chaîne, et les tags absents de Ben ainsi que la city absente d'Ana sont devenus des chaînes vides. L'aller-retour préserve le tableau, pas les types.

Règles pratiques

Situation Ce qui se passe
Les objets ont des clés différentes Les colonnes sont l'union de toutes les clés, dans l'ordre de première apparition
Une valeur est null ou absente La cellule est vide
Une valeur est un objet ou tableau imbriqué Stockée dans la cellule sous forme de texte JSON compact
Un champ contient une virgule, un guillemet ou un saut de ligne La cellule est entre guillemets pour que le CSV reste valide
Ligne CSV plus courte que l'en-tête Les valeurs manquantes deviennent des chaînes vides

Pièges courants

  • Compter sur la conservation des types. Le CSV est du texte. Convertissez nombres et booléens après relecture.
  • Plat contre imbriqué. Si vous avez besoin d'une vraie structure imbriquée, gardez JSON comme source de vérité et n'exportez en CSV que pour les rapports.
  • Tableurs qui déforment les valeurs. Excel peut supprimer les zéros initiaux, transformer les longs nombres en notation scientifique ou réinterpréter du texte ressemblant à une date.
  • Utiliser TSV par erreur. Si vos données contiennent des tabulations ou si vous avez collé depuis un tableur, utilisez les variantes séparées par tabulations.

Pour aller plus loin

Sur la structure de JSON, voir Comment fonctionne JSON ; pour une comparaison avec d'autres formats, voir JSON, YAML ou XML.

Essayez ces outils

Voir aussi

  • Guide Comment fonctionne JSON
    Les six types de valeur JSON, pourquoi l'analyse échoue, pièges des grands entiers et de l'ordre des clés.
  • Comparatif JSON, YAML ou XML
    JSON pour les API et l'échange de données, YAML pour la configuration écrite à la main, XML pour les documents et les normes à schémas.
  • Glossaire JSON
    Le JSON (JavaScript Object Notation) est un format texte léger pour données structurées : objets, tableaux, chaînes, nombres, true.
  • Glossaire CSV
    Le CSV (valeurs séparées par des virgules) est un format de texte brut pour les tableaux.

Questions fréquemment posées

Le CSV n'a pas de types de données : convertir un CSV en JSON produit donc des chaînes, "1" au lieu de 1. Convertissez les champs voulus en nombres ou booléens dans votre code, ou contrôlez-les avec un schéma.

Une cellule CSV ne contient qu'une valeur : un objet ou tableau imbriqué est donc écrit dans la cellule sous forme de texte JSON compact. En reconvertissant, vous récupérez ce texte comme chaîne, pas la structure d'origine.

Non. Les deux convertisseurs fonctionnent dans votre navigateur : les données ne quittent jamais votre appareil.

AdSense Placeholder
Slot: footer_leaderboard