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)
"

Часті запитання