TutorielJSON en CSV

Comment convertir un JSON en CSV (pas à pas, avec exemples)

ParDéveloppeur logiciel
Publié le 4 min de lecture
Un fichier de code JSON transformé en feuille de calcul CSV

Pour convertir un JSON en CSV, ajoutez votre fichier .json au convertisseur JSON en CSV et téléchargez le CSV créé. Chaque objet du tableau JSON devient une ligne, chaque clé devient une colonne, et le fichier s'ouvre dans Excel, Google Sheets ou n'importe quel écran d'import de base de données.

Ce guide présente les trois étapes, l'allure du CSV pour un JSON typique et les structures JSON que le convertisseur comprend, y compris les réponses d'API qui enveloppent les données dans un objet.

Sur cette page
  1. Convertir un JSON en CSV en trois étapes
  2. À quoi ressemble le CSV ?
  3. Quelles structures JSON peut-on convertir ?
  4. Ouvrir le CSV dans Excel sans mauvaise surprise
  5. Et si la conversion échoue ?
  6. JSON en CSV : questions fréquentes

À retenir

  • Un tableau d'objets devient un tableau : une ligne par objet, une colonne par clé.
  • Les colonnes réunissent toutes les clés : les objets auxquels il manque une clé reçoivent une cellule vide au lieu de valeurs décalées.
  • Les objets et tableaux imbriqués sont écrits dans une seule cellule sous forme de texte JSON.
  • Le CSV est enregistré en UTF-8 avec un indicateur d'ordre des octets (BOM), pour qu'Excel affiche correctement les accents.

Convertir un JSON en CSV en trois étapes

  1. 1

    Ajoutez votre fichier JSON. Ouvrez l'outil JSON en CSV et faites glisser votre fichier .json, ou cliquez pour le sélectionner. Vous pouvez en ajouter plusieurs à la fois.

  2. 2

    Convertissez. Cliquez sur Convertir. L'outil vérifie que le fichier est un JSON valide, repère les enregistrements et crée une ligne d'en-tête à partir de toutes les clés rencontrées.

  3. 3

    Téléchargez le CSV. Enregistrez le fichier et ouvrez-le dans votre tableur. Si votre JSON contient plusieurs listes distinctes, chacune devient son propre CSV.

La conversion se fait dans votre navigateur. Les exports JSON contiennent souvent des données de clients ou de commandes, et rien n'est envoyé en ligne.

À quoi ressemble le CSV ?

Entrée : users.json
[
  { "id": 1, "name": "Ana", "email": "ana@example.com" },
  { "id": 2, "name": "Ben", "plan": "pro" }
]
Sortie : users.csv
id,name,email,plan
1,Ana,ana@example.com,
2,Ben,,pro

L'en-tête liste chaque clé dans l'ordre de sa première apparition. Ana n'a pas de plan et Ben n'a pas d'e-mail : ces cellules sont donc vides. Les colonnes ne se décalent jamais, même quand les objets ont des clés différentes.

Quelles structures JSON peut-on convertir ?

Les structures JSON et le CSV qu'elles produisent
Structure JSONExempleRésultat CSV
Tableau d'objets[{...}, {...}]Une ligne par objet
Objet qui enveloppe une liste{ "data": [{...}] }La liste sert de tableau
Objet contenant plusieurs listes{ "users": [...], "orders": [...] }Un CSV par liste, dans un ZIP
Objet unique{ "id": 1, ... }Une ligne d'en-tête et une ligne de données
Tableau de tableaux[[1, "a"], [2, "b"]]Les lignes telles quelles, sans en-tête ajouté
Tableau de valeurs simples["red", "blue"]Une colonne nommée value

Les enregistrements contenant des objets ou des tableaux imbriqués sont traités en détail dans comment convertir un JSON imbriqué en CSV.

Ouvrir le CSV dans Excel sans mauvaise surprise

Le CSV commence par un indicateur d'ordre des octets UTF-8, qui indique à Excel de lire correctement les noms accentués et les symboles. Les valeurs contenant des virgules, des guillemets ou des retours à la ligne sont placées entre guillemets, conformément à la RFC 4180, et restent ainsi dans une seule cellule.

Excel peut malgré tout supprimer les zéros initiaux des codes ou afficher les nombres longs en notation scientifique à l'ouverture de n'importe quel CSV. Si vos données contiennent ce genre d'identifiants, convertissez plutôt directement en classeur avec JSON en Excel, ou lisez comment corriger les caractères spéciaux et les valeurs abîmées dans Excel.

Et si la conversion échoue ?

  • « Le fichier n'est pas un JSON valide ». Cherchez les virgules finales, les guillemets simples ou les commentaires, que le JSON standard n'autorise pas. Un validateur JSON vous indiquera la ligne exacte.
  • « Le tableau JSON est vide ». Le fichier contient [] sans aucun enregistrement à convertir.
  • Les fichiers JSON Lines (.jsonl) contiennent un objet par ligne au lieu d'un tableau. Entourez d'abord les lignes de [ ] et séparez-les par des virgules.

JSON en CSV : questions fréquentes

Comment convertir un fichier JSON en CSV ?

Ajoutez le fichier au convertisseur JSON en CSV, cliquez sur Convertir et téléchargez le CSV. Chaque objet devient une ligne et chaque clé devient une colonne.

Que se passe-t-il si les objets ont des clés différentes ?

L'en-tête contient toutes les clés de tous les objets. Les objets auxquels il manque une clé reçoivent une cellule vide dans cette colonne.

Puis-je convertir une réponse d'API en CSV ?

Oui. Si les enregistrements se trouvent dans une enveloppe comme { "data": [...] }, le convertisseur utilise cette liste comme tableau.

Comment les objets imbriqués sont-ils traités ?

Ils sont écrits dans une seule cellule sous forme de texte JSON, si bien qu'aucune donnée n'est perdue.

Excel affichera-t-il correctement les accents ?

Oui. Le CSV est enregistré en UTF-8 avec un indicateur d'ordre des octets, qu'Excel utilise pour détecter l'encodage.

Du JSON en entrée, un tableur en sortie

Convertir un JSON en CSV permet à n'importe qui d'ouvrir, de filtrer et de partager des données issues d'une API ou d'une application. Vérifiez la ligne d'en-tête, ouvrez le fichier, et les enregistrements sont prêts pour votre tableur ou votre import.

À lire ensuite