Comment convertir un fichier CSV en JSON avec des en-têtes ?

Pour convertir un CSV en JSON avec des en-têtes, il faut associer chaque valeur d’une ligne au nom de sa colonne. Le résultat prend généralement la forme d’une liste d’objets JSON. La première ligne du CSV peut servir automatiquement de référence, ou être remplacée par une liste d’en-têtes définie manuellement.
✓ Vérifié le 3 octobre 2026 · 3 min de lecture

Le principe de la conversion CSV vers JSON

Un fichier CSV contient des lignes et des colonnes séparées par un caractère, généralement une virgule ou un point-virgule. Pour le convertir en JSON, chaque ligne devient un objet et chaque en-tête devient une clé.

Exemple de fichier CSV

nom,age,email
Alice,30,alice@example.com
Bob,25,bob@example.com

Résultat JSON

[
  {
    "nom": "Alice",
    "age": "30",
    "email": "alice@example.com"
  },
  {
    "nom": "Bob",
    "age": "25",
    "email": "bob@example.com"
  }
]

Dans cet exemple, la première ligne fournit les clés nom, age et email. Les valeurs sont généralement conservées sous forme de chaînes de caractères.

Convertir un CSV en JSON avec Python

Le module standard csv de Python permet d’utiliser DictReader. Lorsque aucun nom de champ n’est fourni, la première ligne du fichier est utilisée comme en-tête.

import csv
import json

with open("donnees.csv", "r", encoding="utf-8", newline="") as fichier_csv:
    lignes = csv.DictReader(fichier_csv)
    donnees = list(lignes)

with open("donnees.json", "w", encoding="utf-8") as fichier_json:
    json.dump(donnees, fichier_json, ensure_ascii=False, indent=2)

DictReader associe les valeurs aux en-têtes, tandis que json.dump() écrit les objets dans le fichier JSON. L’option ensure_ascii=False conserve les accents et indent=2 rend le fichier plus lisible.

Convertir un CSV sans ligne d’en-tête

Si le fichier ne contient pas d’en-tête, fournissez les noms de colonnes avec fieldnames.

import csv
import json

en_tetes = ["nom", "age", "email"]

with open("donnees.csv", "r", encoding="utf-8", newline="") as fichier_csv:
    lignes = csv.DictReader(fichier_csv, fieldnames=en_tetes)
    donnees = list(lignes)

with open("donnees.json", "w", encoding="utf-8") as fichier_json:
    json.dump(donnees, fichier_json, ensure_ascii=False, indent=2)

Lorsque fieldnames est utilisé, la première ligne du CSV est traitée comme une ligne de données. Vérifiez donc que le fichier ne contient réellement aucun en-tête.

Gérer un CSV séparé par des points-virgules

Certains tableurs exportent les données avec un point-virgule plutôt qu’une virgule. Indiquez alors le séparateur avec delimiter.

with open("donnees.csv", "r", encoding="utf-8", newline="") as fichier_csv:
    lignes = csv.DictReader(fichier_csv, delimiter=";")
    donnees = list(lignes)

Le séparateur doit correspondre au format réel du fichier. Selon l’application utilisée, il peut s’agir d’une virgule, d’un point-virgule, d’une tabulation ou d’un autre caractère.

Convertir un CSV en JSON avec JavaScript

Avec JavaScript, un analyseur CSV comme csv-parse peut utiliser la première ligne comme noms de colonnes grâce à l’option columns: true.

import fs from "node:fs";
import { parse } from "csv-parse/sync";

const csv = fs.readFileSync("donnees.csv", "utf8");
const donnees = parse(csv, {
  columns: true,
  skip_empty_lines: true
});

fs.writeFileSync("donnees.json", JSON.stringify(donnees, null, 2));

Il est aussi possible de fournir directement un tableau de noms de colonnes au lieu d’utiliser la première ligne du fichier.

Vérifications avant la conversion

  • En-têtes : confirmez que la première ligne contient bien les noms des colonnes.
  • Séparateur : vérifiez s’il s’agit d’une virgule, d’un point-virgule ou d’une tabulation.
  • Guillemets : les champs contenant des virgules ou des retours à la ligne doivent être correctement entourés de guillemets.
  • Nombre de colonnes : assurez-vous que chaque ligne contient le nombre attendu de champs.
  • En-têtes uniques : évitez les noms dupliqués ou invalides afin de prévenir les clés ambiguës.

Convertir les types de données

La lecture avec csv.DictReader produit généralement des chaînes de caractères. Ainsi, "30" devient une chaîne JSON et non le nombre 30. Si des nombres, booléens ou valeurs nulles sont nécessaires, convertissez-les explicitement avant l’écriture.

for ligne in donnees:
    ligne["age"] = int(ligne["age"])

Cette étape dépend de la structure attendue par l’application qui consommera le fichier JSON.

À retenir

  • Utilisez la première ligne du CSV comme en-têtes avec csv.DictReader ou columns: true.
  • Fournissez fieldnames si le CSV ne contient pas de ligne d’en-tête.
  • Indiquez le bon séparateur avec delimiter lorsque le fichier utilise des points-virgules.
  • Les valeurs restent généralement des chaînes : convertissez explicitement les nombres, booléens et valeurs nulles.
  • Contrôlez les guillemets, les colonnes manquantes et les en-têtes dupliqués avant la conversion.

Questions fréquentes

La première ligne d’un CSV devient-elle automatiquement l’en-tête ?
Oui, avec Python et csv.DictReader lorsqu’aucun fieldnames n’est fourni. Avec JavaScript et csv-parse, utilisez l’option columns: true.
Comment convertir un CSV séparé par des points-virgules ?
Avec Python, ajoutez delimiter=";" à csv.DictReader. Le séparateur doit correspondre à celui réellement utilisé dans le fichier.
Pourquoi les nombres sont-ils enregistrés comme du texte ?
Le module CSV lit généralement les valeurs sous forme de chaînes. Convertissez explicitement les champs concernés, par exemple avec int() ou float(), avant de créer le JSON.
Que faire si le CSV ne contient pas d’en-têtes ?
Définissez vous-même une liste de noms de colonnes et transmettez-la à fieldnames. La première ligne sera alors interprétée comme une ligne de données.

Sources & vérification

Les informations de ce guide s’appuient sur les sources ci-dessous. Elles sont conservées pour faciliter les vérifications et les mises à jour.