Конвертер JSON в CSV

Что такое CSV и зачем конвертировать из JSON?

// Input JSON
[
  { "id": 1, "name": "Alice", "role": "admin" },
  { "id": 2, "name": "Bob", "role": "editor" }
]

// Output CSV (RFC 4180 preset: comma + CRLF + no BOM)
id,name,role
1,Alice,admin
2,Bob,editor

// Same input with Stringify mode + nested data
[
  { "id": 1, "tags": ["a", "b"] }
]

// Becomes
id,tags
1,"[""a"",""b""]"

Ключевые возможности

Примеры

[{"id":1,"name":"Alice Chen","email":"alice@example.com","role":"admin"},{"id":2,"name":"Bob Garcia","email":"bob@example.com","role":"editor"},{"id":3,"name":"Carol Singh","email":"carol@example.com","role":"viewer"},{"id":4,"name":"Dan Müller","email":"dan@example.com","role":"viewer"}]

[{"id":1001,"title":"Bug: login redirects to 404","state":"open","labels":["bug","priority:high"],"user":{"login":"alice"}},{"id":1002,"title":"Feature: dark mode toggle","state":"open","labels":["enhancement"],"user":{"login":"bob"}},{"id":1003,"title":"Docs: update README","state":"closed","labels":["docs","good-first-issue"],"user":{"login":"carol"}}]

[{"_id":{"$oid":"6634a1b2c3d4e5f600000001"},"email":"alice@example.com","metadata":{"signupDate":"2026-01-15T10:30:00Z","preferences":{"newsletter":true,"theme":"dark"}}},{"_id":{"$oid":"6634a1b2c3d4e5f600000002"},"email":"bob@example.com","metadata":{"signupDate":"2026-02-20T14:15:00Z","preferences":{"newsletter":false,"theme":"light"}}}]

{"event":"signup","user":"alice","ts":1715000000}
{"event":"login","user":"alice","ts":1715000060}
{"event":"checkout","user":"alice","ts":1715000300}

[{"id":"ord-001","customer":{"name":"Alice Chen","email":"alice@example.com","address":{"city":"Seattle","country":"US"}},"items":[{"sku":"SKU-100","qty":2},{"sku":"SKU-205","qty":1}]},{"id":"ord-002","customer":{"name":"Bob Garcia","email":"bob@example.com","address":{"city":"Madrid","country":"ES"}},"items":[{"sku":"SKU-100","qty":1}]}]

[{"name":"GET /users returns 200","status":"pass","duration":142},{"name":"POST /users creates record","status":"pass","duration":287},{"name":"GET /users/999 returns 404","status":"fail","duration":98,"error":"Expected 404, got 500"},{"name":"DELETE /users/1 returns 204","status":"pass","duration":156}]

Как использовать

1. 1

   Вставьте JSON

   Введите или вставьте JSON в поле ввода выше. Инструмент принимает массивы объектов, одиночные объекты и NDJSON (JSON со строчным разделителем) — определяется автоматически. Можно нажать «Загрузить пример», чтобы попробовать на образце — ответе REST API, экспорте MongoDB или журнале событий NDJSON.

2. 2

   Выберите пресет (или настройте параметры)

   Нажмите RFC 4180 (по умолчанию), Excel (точка с запятой EU + BOM), TSV (Tab) или Pipe, чтобы настроить целевой формат одним кликом. Откройте панель «Настройки» для тонкой регулировки: разделитель, заголовок, кавычки (Auto/Always), окончание строк (LF/CRLF), BOM и вложенные (Flatten/Stringify).

3. 3

   Скопируйте или скачайте CSV

   Нажмите «Скопировать», чтобы поместить CSV в буфер обмена, или «Скачать», чтобы сохранить как .csv (.tsv при пресете TSV) для Excel, Google Sheets, PostgreSQL COPY или любого data-конвейера. Для round-trip нажмите «Поменять направление», чтобы преобразовать CSV обратно в JSON на месте.

Типичные ловушки конвертации

42

[{"value": 42}]

[
  {"name": "GET /users", "status": "pass"},
  {"name": "GET /users/999", "status": "fail", "error": "500"}
]

// Output CSV (note empty cell in row 1)
name,status,error
GET /users,pass,
GET /users/999,fail,500

{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

{"id": "9007199254740993"}
// CSV preserves the string; Excel displays exactly

name,role
Smith, Jr.,admin
// Parser reads 3 columns: "Smith", " Jr.", "admin"

name,role
"Smith, Jr.",admin
// Parser reads 2 columns: "Smith, Jr.", "admin"

id,name,price
1,Alice,1,234.56
// Excel-EU mis-parses 1,234.56 as two columns

// Excel preset output: ; + CRLF + BOM
id;name;price
1;Alice;1234,56
// Excel-EU reads cleanly with comma decimal

[
  {"event": "signup"},
  {"event": "login"}
]
// Detected as a regular JSON array (works, but not NDJSON path)

{"event": "signup"}
{"event": "login"}
// Each line is one JSON value — auto-detected as NDJSON

Типичные сценарии

Ответ API в таблицу

Вставьте ответ REST API (массив объектов user/order/event) и получите аккуратный табличный CSV, готовый для Excel, Google Sheets или Numbers. Самый частый сценарий — аналитикам и PM нужны данные в табличной форме, инженеры отдают JSON с бэкенда.

Экспорт MongoDB в data warehouse

Преобразуйте JSON-вывод mongoexport (с обёртками $oid и вложенными metadata-документами) в CSV для загрузки в BigQuery, Snowflake или Redshift. Режим Stringify сохраняет вложенную форму без потерь, когда внешние инструменты поддерживают JSON-в-ячейке.

Триаж GitHub Issues

Получите issues из /repos/{owner}/{repo}/issues, вставьте JSON и получите плоский CSV с колонками id, title, state, labels и user.login. Перетащите в Sheets, чтобы фильтровать, сортировать и распределять во время планирования спринта.

Просмотр журнала событий NDJSON

Потоковые журналы из Cloud Logging, Datadog, Vector или собственного конвейера часто приходят как NDJSON (.ndjson, .jsonl). Вставьте содержимое файла напрямую — определится автоматически — и получите CSV для ad-hoc анализа без подъёма реального ETL-конвейера.

Извлечение заказов e-commerce

Преобразуйте вложенный JSON заказов (customer.address.city, массив items) в плоский CSV для финансов, фулфилмента или fraud-обзора. Режим Flatten выдаёт по одной колонке на листовое поле, готовое для загрузки в Excel под ad-hoc отчётность.

Отчёт о тестах Postman/Newman

Экспорты тестов Postman содержат строки разной формы (некоторые с необязательным полем error). Вставьте JSON, получите CSV с объединением всех ключей и заполненными пустыми ячейками — идеально для шаринга отчётов по упавшим тестам с не-инженерами в Sheets.

Технические детали

Парсер RFC 4180 на конечном автомате

Оба направления используют полноценный парсер на конечном автомате по RFC 4180. Состояния — UnquotedField, QuotedField, AfterQuote, RowEnd и EndOfInput. Парсер корректно обрабатывает поля в кавычках с разделителем внутри, вложенные CR/LF в полях в кавычках, экранированные двойные кавычки (удвоением, как "") и концевые переносы строк. На выходе — round-trip без потерь через модуль csv в Python, PostgreSQL COPY, AWS S3 SELECT и любой совместимый парсер.

Алгоритм обнаружения больших целых

Перед прогоном JSON через JSON.parse() (который молча округлил бы большие целые через IEEE 754) инструмент сканирует исходный текст JSON регуляркой в поисках целочисленных литералов вне безопасного диапазона (-2^53+1 до 2^53-1). При обнаружении затронутые пути полей записываются, и под выводом появляется баннер Big-integer warning. Затем CSV-писатель сохраняет эти значения как строки, обеспечивая точное совпадение через Excel, Google Sheets и любого внешнего потребителя, понимающего текст.

BOM и кодировка UTF-8 для Excel

Весь ввод и вывод — UTF-8. Необязательный UTF-8 BOM (0xEF 0xBB 0xBF) добавляется в начало вывода, когда переключатель BOM включён или выбран пресет Excel. Excel в Windows использует BOM, чтобы определить кодировку UTF-8 — без него Excel откатывается к системной локали (Windows-1252 в США, Windows-1251 в России и т. д.) и портит не-ASCII символы. Современные парсеры (Python csv, Pandas, jq, PostgreSQL) обычно не нуждаются в BOM и могут включить его как лишний символ в начале первой ячейки, поэтому для не-Excel конвейеров оставляйте BOM выключенным.

Лучшие практики

Сначала пресет, потом тонкая настройка

Пресеты RFC 4180, Excel, TSV и Pipe настраивают пять параметров за раз (разделитель, окончание строк, режим кавычек, BOM, заголовок). Сначала выберите ближайший пресет, затем при необходимости подстройте отдельные параметры — это убережёт от частой ошибки переключить один параметр и забыть другой (например, перейти на точку с запятой, но оставить LF, что Excel-EU в Windows всё равно неверно разберёт).

Flatten для анализа, Stringify для round-trip

Используйте Flatten, когда цель — Excel, Sheets или одноразовый анализ: ключи через точку дают самую чистую табличную раскладку. Используйте Stringify, когда нужен round-trip CSV → JSON → CSV без потерь: массивы и объекты выживают как JSON внутри одной ячейки. Сменить режим и перезапустить дёшево; выбирайте под потребителя.

BOM — только для Excel

UTF-8 BOM нужен Excel в Windows, чтобы корректно определить кодировку. Любой другой парсер (Python csv, Pandas, jq, PostgreSQL COPY, BigQuery) либо игнорирует BOM, либо включает его как лишний символ в начале первой ячейки, ломая имена колонок. Для конвейеров оставляйте BOM выключенным и включайте (или используйте пресет Excel) только когда цель — Excel.

Большие ID — строками в JSON

Snowflake-ID Twitter, ID Discord, поля Long в MongoDB и resourceVersion в K8s — это 64-битные целые, превышающие безопасный диапазон JavaScript (2^53 - 1). Храните их как JSON-строки ("id": "9007199254740993") перед конвертацией — CSV сохранит цифры точно, тогда как числовой литерал JSON.parse() молча округлит.

Проверяйте форму строк перед загрузкой

Строки разной формы (у одних объектов есть ключи, у других нет) сливаются с пустыми ячейками в выводе, и инструмент показывает предупреждение Schema notes. Для потребителей со строгой схемой (BigQuery, Redshift COPY) проверьте, что все строки имеют одинаковый набор ключей перед экспортом — или явно обработайте пропуски в конвейере. Используйте наш форматировщик JSON, чтобы сначала изучить форму ввода.

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