Guide complet de la conversion CSV vers JSON
Différences structurelles entre CSV et JSON
CSV (Comma-Separated Values) et JSON (JavaScript Object Notation) sont deux des formats de données les plus courants, mais leurs structures sont fondamentalement différentes :
| Caractéristique | CSV | JSON |
|---|---|---|
| Structure | Tableau plat | Arbre imbriqué |
| Types de données | Tout en chaînes | Chaîne, nombre, booléen, null |
| Imbrication | Non supportée | Support natif |
| Commentaires | Non supportés | Non supportés (JSON5 oui) |
| Cas d'utilisation | Données tabulaires, export Excel | Réponses d'API, fichiers de configuration |
Règles de conversion expliquées
CSV vers JSON
Chaque ligne CSV est convertie en un objet JSON. La première ligne sert de clés (en-têtes) et les lignes suivantes fournissent les valeurs :
name,age,city
Alice,28,New York
Bob,32,London
Résultat de la conversion :
[
{ "name": "Alice", "age": 28, "city": "New York" },
{ "name": "Bob", "age": 32, "city": "London" }
]
JSON vers CSV
Chaque objet d'un tableau JSON est développé en une ligne CSV, les clés de l'objet formant la ligne d'en-tête.
Convertir avec l'Outil JSON↔CSV
Étape 1 : Préparez vos données
Assurez-vous que votre fichier CSV est bien formé : la première ligne contient les en-têtes, chaque ligne a le même nombre de champs et les champs contenant des virgules sont entre guillemets doubles.
Étape 2 : Choisissez la direction de conversion
Ouvrez l'Outil JSON↔CSV et sélectionnez le mode "CSV → JSON" ou "JSON → CSV".
Étape 3 : Collez ou téléchargez les données
Collez vos données dans la zone de saisie, ou téléchargez directement un fichier .csv ou .json.
Étape 4 : Configurez les options
- Délimiteur : Par défaut la virgule ; supporte aussi la tabulation (TSV) et le point-virgule
- Inclure les en-têtes : Contrôle si la première ligne est traitée comme noms de champs
- Expansion de l'imbrication : Comment les objets imbriqués dans JSON sont traités
- Détection automatique des nombres : Convertit automatiquement
"28"en28
Étape 5 : Obtenez les résultats
Cliquez sur le bouton de conversion. Les résultats apparaissent instantanément dans la zone de sortie et peuvent être copiés ou téléchargés en un clic.
Gestion des en-têtes
Les en-têtes sont le cœur du CSV. Lors de la conversion, notez :
- Les espaces et caractères spéciaux dans les en-têtes sont conservés comme clés JSON
- Utilisez la nomination en minuscules + tiret bas (ex.,
user_name) pour faciliter le traitement en aval - Si le CSV n'a pas d'en-tête, l'outil génère automatiquement des noms de colonnes par défaut comme
col_1,col_2
Gestion des objets imbriqués
CSV ne supporte pas nativement l'imbrication, mais certains fichiers CSV utilisent la notation par points pour la hiérarchie :
user.name,user.email,order.id
Alice,alice@example.com,1001
Activez l'option "Auto-étendre l'imbrication" dans l'Outil JSON↔CSV pour générer :
{
"user": { "name": "Alice", "email": "alice@example.com" },
"order": { "id": 1001 }
}
Conseils pour le traitement des fichiers volumineux
- Pour les fichiers CSV de plus de 10 Mo, envisagez la conversion par lots
- Utilisez le traitement par flux pour éviter le débordement de mémoire
- L'outil prend en charge la conversion en ligne de fichiers jusqu'à 50 Mo
- Pour les très gros fichiers, prétraitez localement avec Python (pandas)
Erreurs courantes et solutions
| Erreur | Cause | Solution |
|---|---|---|
| Nombre de champs incohérent | Virgule en trop/manquante dans une ligne | Vérifiez que les guillemets sont complets |
| Texte illisible (encodage) | Le fichier n'est pas en UTF-8 | Convertissez l'encodage avec un éditeur de texte d'abord |
| Échec de l'analyse JSON | Format invalide | Corrigez avec le Formateur JSON |
| Échec de l'expansion d'imbrication | Hiérarchie de clés irrégulière | Vérifiez la cohérence des séparateurs par points |
Conseils pratiques
- Formatez la sortie avec le Formateur JSON après la conversion
- Validez rapidement les résultats avec JSONPath
- Le CSV exporté d'Excel contient souvent un en-tête BOM — supprimez-le avant la conversion
- Standardisez les champs de date au format ISO 8601
Résumé
La conversion CSV vers JSON est une opération fréquente dans le développement quotidien. Comprendre les différences structurelles et les règles de conversion, combiné avec l'Outil JSON↔CSV, permet une conversion efficace des formats de données. Pour les scénarios d'imbrication complexe ou de fichiers volumineux, appliquez les conseils de ce guide pour résoudre les problèmes un par un.