Вставляєте JSON, отримуєте таблицю й CSV-файл, який відкриється в Excel, Google Sheets чи LibreOffice. Це і є суть цього інструмента. Решта статті про те, що відбувається між цими двома кроками, і про місця, де конвертація тихо ламає дані, а ви помічаєте це тільки на звіті для начальства.
А ще у мене зібрано безкоштовні онлайн-інструменти для щоденних завдань, якщо після картинок доведеться щось конвертувати, перевірити чи підрахувати.
JSON to CSV & Table Converter
Миттєво перетворюйте масиви та об’єкти JSON у таблицю або CSV-формат із можливістю експорту прямо у вашому браузері
Параметри конвертації та експорту
Що робить JSON to CSV & Table Converter
JSON зберігає дані у вигляді об’єктів і масивів. CSV зберігає їх у вигляді плоских рядків. Конвертер перекладає з однієї мови на другу: кожен об’єкт стає рядком, кожен ключ стає назвою колонки.
Звідси перше обмеження. Таблиця плоска, а JSON може вкладатися на десять рівнів углиб. Усе цікаве в конвертації відбувається саме там, де ці два світи не збігаються.
Формат JSON описано в RFC 8259. Об’єкт там визначено як невпорядковану колекцію пар «ім’я — значення», а масив як впорядковану послідовність значень. Порядок ключів в об’єкті стандарт не гарантує, тож не будуйте логіку на тому, що колонки опиняться в тому самому порядку, в якому ви їх бачили в джерелі.
Як конвертувати JSON у CSV
Найпростіший сценарій займає хвилину.
- Візьміть JSON. Найзручніше, коли це масив об’єктів, де кожен об’єкт описує один запис.
- Вставте його в конвертер.
- Перегляньте таблицю й переконайтеся, що колонки й рядки виглядають так, як ви очікували.
- Збережіть результат як CSV.
Приклад вхідних даних:
[
{"id": 1, "name": "Олена", "city": "Харків"},
{"id": 2, "name": "Андрій", "city": "Львів", "phone": "0501234567"}
]Результат:
id,name,city,phone
1,Олена,Харків,
2,Андрій,Львів,0501234567Зверніть увагу на порожнє значення в першому рядку. У першого об’єкта немає ключа phone, тому колонка є, а клітинка порожня. Це нормально. Нормально й те, що набір колонок збирається з усіх об’єктів разом, а не з першого. Якщо інструмент бере заголовки лише з першого запису, дані з наступних записів губляться без жодного попередження, а це гірше за будь-яку помилку.
Що робити з вкладеними об’єктами і масивами
Ось де починається справжня робота. Візьмемо замовлення:
{
"id": 101,
"customer": {"name": "Іра", "city": "Київ"},
"items": [
{"sku": "A1", "qty": 2},
{"sku": "B7", "qty": 1}
]
}З вкладеним об’єктом customer усе відносно просто. Його розгортають у колонки з назвами через крапку, customer.name і customer.city. Так робить, наприклад, функція json_normalize у бібліотеці pandas, де роздільник за замовчуванням якраз крапка, а глибину розгортання можна обмежити параметром max_level.
З масивом items складніше, і тут є три різні підходи.
| Підхід | Що виходить | Коли підходить |
|---|---|---|
| Масив як текст в одній клітинці | Один рядок на замовлення, у клітинці лежить фрагмент JSON | Масив вам не потрібен для аналізу, лише для довідки |
| Один рядок на кожен елемент масиву | Дані замовлення повторюються у кількох рядках | Потрібно рахувати, фільтрувати, будувати зведені таблиці за позиціями |
Окремі колонки items.0.sku, items.1.sku | Широка таблиця з купою порожніх клітинок | Масиви короткі й однакової довжини |
Другий варіант для аналітики зазвичай найкорисніший. Вигляд буде такий:
id,customer.name,customer.city,sku,qty
101,Іра,Київ,A1,2
101,Іра,Київ,B7,1Pandas робить саме так, коли ви вказуєте шлях до масиву записів (record_path) і поля, які треба повторити в кожному рядку (meta). Ціна цього підходу в тому, що кількість рядків більше не дорівнює кількості замовлень. Якщо потім порахувати суму по колонці, яка повторюється, отримаєте завищений результат. Це одна з найтиповіших помилок після такої конвертації.
Коли JSON не перетворюється на таблицю
Не кожен JSON має табличну природу. Якщо в ньому лежить дерево категорій, граф зв’язків або конфігурація з різнорідних блоків, плоска таблиця буде штучною. Конвертер видасть щось, але користі від цього «щось» може не бути.
Хороший тест такий. Чи можна одним реченням описати, що таке один рядок? «Один рядок це один користувач». «Один рядок це одна позиція в замовленні». Якщо відповідь не формулюється, проблема в структурі даних, а не в інструменті.
Як CSV має виглядати, щоб його не зламали
CSV здається примітивним, але чіткого єдиного стандарту в нього немає. RFC 4180, який часто називають довідковим, є інформаційним документом, а не формальним стандартом, і сам визнає, що реалізації помітно відрізняються. Проте основні правила там зафіксовано, і їх варто знати.
- Поля, що містять коми, подвійні лапки чи переноси рядків, беруться в подвійні лапки.
- Лапка всередині поля подвоюється.
- Кожен запис має містити однакову кількість полів.
Приклад. Текст Привіт, "світе" у CSV виглядатиме так:
"Привіт, ""світе"""Саме через ці правила вручну склеювати CSV із рядків (join(",")) не варто. Перший же коментар клієнта з комою в тексті розсуне колонки на одну вправо, і так для кожного рядка нижче.
Чому Excel показує абракадабру й усе в одній колонці
Тут нічого не зламано. Просто Excel складніший, ніж здається.
Кракозябри замість кирилиці. За даними з кількох технічних довідників, Excel при подвійному кліку розпізнає UTF-8 лише тоді, коли на початку файлу стоїть BOM, службова послідовність байтів EF BB BF. Без неї Excel читає файл у системному кодуванні. Для українського тексту це типова причина кракозябрів. Є два виходи: імпортувати файл через Дані → З тексту/CSV і вручну вибрати кодування UTF-8, або зберегти файл як UTF-8 із BOM.
Усе злиплося в одну колонку. Excel розбиває рядок за роздільником зі списку регіональних налаштувань Windows. У багатьох європейських регіонах це крапка з комою, а не кома. Якщо ваш CSV із комами, а система очікує крапку з комою, отримаєте одну довгу колонку. Допомагає той самий імпорт через З тексту/CSV, де роздільник вибирається вручну. Також можна додати першим рядком файлу службову стрічку sep=,, хоча це вже обхідний трюк, і не всі програми її розуміють.
Перше, що варто зробити після будь-якого експорту, це відкрити файл у простому текстовому редакторі. Ви побачите, що саме було записано, без жодного втручання Excel.
Ідентифікатори, нулі та довгі числа
Ще одна пастка. Телефон 0501234567 у JSON є рядком, у CSV він виглядає як звичайний текст, але Excel може вирішити, що це число, і прибрати нуль на початку.
Microsoft у довідці про збереження початкових нулів і довгих чисел прямо пише, що Excel має максимальну точність 15 значущих цифр, а все після п’ятнадцятої цифри обнуляється. Тож для 16-значних кодів, як-от номери карток чи довгі ідентифікатори, потрібен текстовий формат. У довідці також сказано, що в Excel для Microsoft 365 і Excel 2024 є параметр автоматичних перетворень даних. Ним можна вимкнути видалення нулів та перетворення довгих чисел у наукову нотацію.
Практична порада проста. Якщо в даних є коди, телефони, поштові індекси або довгі ID, імпортуйте CSV через «З тексту/CSV» і для цих колонок вибирайте тип «Текст». Не відкривайте такий файл подвійним кліком.
Безпека, або Чому CSV може виконати чужу формулу
Це та частина, яку зазвичай пропускають, а даремно.
OWASP описує атаку, відому як CSV Injection, або Formula Injection. Суть у тому, що Excel чи LibreOffice Calc інтерпретують клітинку, яка починається з =, як формулу. За OWASP, формули також можуть спрацьовувати для клітинок, що починаються з +, - чи @, а до небезпечних символів додано табуляцію та повернення каретки. Якщо у вашому JSON є текст, який ввів хтось сторонній (відгуки, імена, коментарі), а ви передаєте CSV колезі, який відкриє його в Excel, то така клітинка теж може спрацювати як формула.
Типові варіанти захисту від OWASP такі. Додати перед небезпечним значенням одинарну лапку або обгорнути значення лапками. Але в самому OWASP зазначено, що універсального способу, безпечного для всіх програм і всіх споживачів файлу, немає, а Excel при повторному збереженні може прибрати службові символи, і формула знову стане активною.
Висновок такий. Якщо CSV складений із даних, які вводили сторонні люди, і ви передаєте його далі для відкриття в таблицях, переглядайте клітинки, що починаються з =, +, -, @. Якщо файл потрібен лише для машинної обробки, а не для читання людиною, цю захисну обробку, навпаки, краще не застосовувати, бо вона змінить самі дані.
CSV чи таблиця: що обрати
Таблиця, яку показує конвертер, зручна, щоб швидко оцінити структуру. Подивитися, чи правильно розгорнулися вкладені поля, чи немає порожніх колонок, чи не з’їхали значення. CSV потрібен, коли дані треба кудись завантажити: у Excel, Google Sheets, базу даних, CRM чи інструмент аналітики.
Якщо потрібна лише швидка перевірка, достатньо таблиці. Якщо потрібен файл для передачі, беріть CSV і перед відправкою відкрийте його в текстовому редакторі.
Типові помилки, яких легко уникнути
- Конвертувати JSON з об’єктами різної структури й не перевірити, чи з’явилися колонки з усіх записів.
- Розгортати масиви в рядки й потім сумувати колонку, значення якої повторюються.
- Відкривати CSV подвійним кліком замість імпорту, коли в даних є кирилиця, коди чи довгі числа.
- Збирати CSV вручну без екранування ком і лапок.
- Передавати файл із чужими текстами в Excel без перегляду клітинок, що починаються з
=. - Вважати, що порядок колонок гарантований, бо стандарт JSON порядок ключів у об’єкті не фіксує.
Часті запитання
Чи можна конвертувати JSON у CSV без програмування?
Так, для цього й існують онлайн-конвертери. Вставляєте JSON, перевіряєте таблицю, зберігаєте CSV.
Що буде, якщо в об’єктів різні набори ключів?
Коректний конвертер збирає колонки з усіх об’єктів, а відсутні значення залишає порожніми.
Чому в Excel українські літери стали незрозумілими символами?
Найімовірніше, Excel прочитав UTF-8 файл в іншому кодуванні. Імпортуйте файл через «Дані → З тексту/CSV» і виберіть кодування UTF-8.
Чи зберігається тип даних під час конвертації?
CSV не має типів. Усе в ньому текст, а типи вгадує програма, яка відкриває файл. Тому нулі на початку й довгі числа можуть постраждати вже в Excel.
Чим CSV відрізняється від JSON?
JSON підтримує вкладеність і типи значень, CSV це плоска таблиця з текстових значень. Для обміну табличними даними CSV зручніший, для складних структур точніший JSON.
Підсумок
Конвертація JSON у CSV це п’ять секунд. Усе, що може піти не так, відбувається поза цими секундами: у структурі даних, у кодуванні, у регіональних налаштуваннях Excel і в тому, як ця програма вирішує, що є числом, а що формулою. Перевіряйте таблицю перед збереженням, відкривайте готовий файл у текстовому редакторі й імпортуйте в Excel через «З тексту/CSV».
Автор: Lumir
Дивіться також:
Markdown в HTML: безкоштовний онлайн-конвертер
HTML Cleaner: як очистити HTML-код від сміття без втрати змісту
Text Cleaner: як швидко очистити та відформатувати текст онлайн







