CSV to JSON

Что такое конвертация CSV в JSON?

CSV (Comma-Separated Values) — это текстовый табличный формат, в котором каждая строка представляет запись, а поля внутри записи разделены символом-разделителем, как правило запятой. CSV является стандартным форматом обмена данными с первых дней персональных компьютеров и формализован в RFC 4180. Электронные таблицы, базы данных и инструменты экспорта данных работают с CSV, поскольку этот формат прост, компактен и поддерживается практически любым языком программирования.

JSON (JavaScript Object Notation) представляет структурированные данные в виде пар ключ-значение и упорядоченных массивов. В отличие от CSV, JSON поддерживает вложенные объекты, типизированные значения (числа, булевы, null) и записи переменной длины. Поскольку JSON нативно понимается движками JavaScript, он является доминирующим форматом для обмена данными между браузером и сервером и для ответов REST API. Эти свойства делают JSON форматом по умолчанию для веб-API, конфигурационных файлов и NoSQL-баз данных, таких как MongoDB и CouchDB.

Конвертация CSV в JSON означает преобразование каждой строки таблицы в JSON-объект: строка заголовков становится именами свойств, а значения ячеек — значениями свойств. Результатом обычно является JSON-массив объектов. Такое преобразование необходимо, когда нужно передать плоские табличные данные в систему, ожидающую структурированный JSON: REST API, компонент таблицы данных во фронтенде или документоориентированную базу данных.

Зачем использовать этот инструмент?

Этот конвертер разбирает CSV в браузере, мгновенно формирует JSON-вывод и никогда не отправляет ваши данные на сервер.

Сценарии использования CSV to JSON

Справочник разделителей CSV

CSV-файлы не всегда используют запятые. Разделитель зависит от локали, приложения-экспортёра и содержимого данных. Ниже приведены четыре наиболее распространённых разделителя и типичные случаи их применения:

CSV и JSON: структурные различия

Различие между двумя форматами объясняет, почему при конвертации необходимо явно принимать решения о сопоставлении заголовков, определении типов и обработке отсутствующих значений.

Примеры кода

Как программно конвертировать CSV в JSON на популярных языках и с помощью CLI-инструментов:

// Simple CSV string → JSON array
const csv = `name,age,city
Alice,30,Berlin
Bob,25,Tokyo`

const [headerLine, ...rows] = csv.trim().split('\n')
const headers = headerLine.split(',')
const json = rows.map(row => {
  const values = row.split(',')
  return Object.fromEntries(headers.map((h, i) => [h, values[i]]))
})
// → [{ name: "Alice", age: "30", city: "Berlin" }, ...]

// With the built-in fetch + a library (Papa Parse)
import Papa from 'papaparse'
const result = Papa.parse(csvString, { header: true, dynamicTyping: true })
console.log(result.data) // typed numbers and booleans

import csv, json, io

csv_string = """name,age,city
Alice,30,Berlin
Bob,25,Tokyo"""

reader = csv.DictReader(io.StringIO(csv_string))
data = [row for row in reader]
print(json.dumps(data, indent=2))
# → [{"name": "Alice", "age": "30", "city": "Berlin"}, ...]

# With type coercion (age as int)
import pandas as pd
df = pd.read_csv(io.StringIO(csv_string))
print(df.to_json(orient="records", indent=2))
# → [{"name": "Alice", "age": 30, "city": "Berlin"}, ...]

package main

import (
	"encoding/csv"
	"encoding/json"
	"fmt"
	"strings"
)

func main() {
	input := "name,age,city\nAlice,30,Berlin\nBob,25,Tokyo"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()

	headers := records[0]
	var result []map[string]string
	for _, row := range records[1:] {
		obj := make(map[string]string)
		for i, h := range headers {
			obj[h] = row[i]
		}
		result = append(result, obj)
	}

	out, _ := json.MarshalIndent(result, "", "  ")
	fmt.Println(string(out))
	// → [{"age":"30","city":"Berlin","name":"Alice"}, ...]
}

# Using Miller (mlr) — handles quoting, types, and edge cases
mlr --icsv --ojson cat data.csv
# → [{"name": "Alice", "age": 30, "city": "Berlin"}, ...]

# Using csvjson from csvkit (Python-based)
csvjson data.csv

# Using jq with @csv (reverse: JSON → CSV)
# For CSV → JSON, pipe through Miller or Python
cat data.csv | python3 -c "
import csv, json, sys
reader = csv.DictReader(sys.stdin)
json.dump(list(reader), sys.stdout, indent=2)
"

Часто задаваемые вопросы