Convertir CSV en JSON : guide pratique et pièges à éviter

Le CSV est la langue des tableurs ; le JSON, celle des applications web et des API. Tôt ou tard, il faut passer de l’un à l’autre : importer une liste de produits, alimenter une base de données ou nourrir un script. La conversion semble simple, mais quelques détails décident si vos données arrivent intactes.

Comment un CSV devient du JSON

Un fichier CSV est un tableau. La première ligne contient généralement les noms des colonnes :

id,name,city,zip
1,Ana,Vilnius,01100
2,Ben,Austin,73301

La forme JSON la plus courante est un tableau d’objets : un objet par ligne, avec les noms de colonnes comme clés :

[
  { "id": 1, "name": "Ana", "city": "Vilnius", "zip": "01100" },
  { "id": 2, "name": "Ben", "city": "Austin", "zip": "73301" }
]

C’est exactement ce que produit par défaut le convertisseur CSV en JSON.

Piège n° 1 : les nombres qui n’en sont pas

Remarquez que id est devenu un nombre, mais que zip est resté une chaîne de caractères. C’est voulu. Codes postaux, numéros de téléphone, numéros de compte et références produit commencent souvent par un zéro. Traitez 01100 comme un nombre et il devient discrètement 1100 : un bug qui peut passer inaperçu pendant des mois.

FileCrafty détermine les types colonne par colonne : une colonne n’est convertie en nombres que si toutes ses valeurs sont des nombres propres. Dès qu’une seule valeur commence par un zéro ou n’est pas numérique, toute la colonne reste du texte.

Piège n° 2 : le mauvais séparateur

Les fichiers « séparés par des virgules » ne le sont pas toujours. En France et dans une grande partie de l’Europe, Excel enregistre les CSV avec des points-virgules, car la virgule y sert de séparateur décimal. Les fichiers séparés par des tabulations (TSV) sont aussi très courants. Le convertisseur détecte automatiquement le séparateur, donc 1;Ana;Vilnius est découpé correctement.

Piège n° 3 : virgules et guillemets dans les valeurs

Une valeur comme "Smith, John" contient une virgule ; elle est donc entourée de guillemets dans le CSV. Les guillemets à l’intérieur d’une valeur sont doublés : "He said ""hi""". Les conversions naïves qui se contentent de couper à chaque virgule cassent ces lignes. Un vrai analyseur CSV, comme celui du convertisseur, gère les champs entre guillemets, les virgules intégrées et même les retours à la ligne dans une cellule.

Piège n° 4 : les cellules vides

Une cellule vide peut signifier « aucune valeur » ou « texte vide ». En JSON, ce n’est pas la même chose : null d’un côté, "" de l’autre. Vérifiez ce qu’attend le système dans lequel vous importez les données, et contrôlez quelques enregistrements après la conversion.

Dans l’autre sens

Besoin de transformer une réponse d’API en tableur ? JSON en CSV aplatit les objets imbriqués en colonnes comme address.city, et JSON en Excel vous donne directement un fichier .xlsx. Pour vérifier ou mettre en forme du JSON avant de l’utiliser, collez-le dans le formateur JSON : il indique la ligne et la colonne de chaque erreur de syntaxe.

Vos données restent privées

Les listes de clients et les exports contiennent souvent des données personnelles. Le convertisseur fonctionne entièrement dans votre navigateur : le fichier n’est jamais envoyé sur un serveur.

En bref

Déposez votre fichier dans CSV en JSON, vérifiez l’aperçu et téléchargez le résultat. Zéros initiaux, points-virgules et virgules entre guillemets sont gérés pour vous.