Данные и таблицы

Превратить JSON в CSV

Разворачивает массив JSON-объектов в плоскую таблицу CSV, включая вложенные поля.

Python Windows macOS Linux Новичок
Скачать json_to_csv.py
Описание

Что делает скрипт

Скрипт принимает массив объектов, объект с массивом внутри или одиночный объект. Вложенные словари разворачиваются в колонки с точками, массивы сохраняются как JSON-строка. Набор колонок собирается по всем записям, поэтому разные объекты не теряют поля. Исходный JSON не изменяется.

Перед запуском
  • Массивы внутри объектов сохраняются как JSON-строки, а не разворачиваются в отдельные строки.
Запуск

Быстрый старт

python json_to_csv.py --input data.json --output data.csv

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python json_to_csv.py --input users.json --array-key items
  • python json_to_csv.py --input report.json --delimiter ';' --force
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

json_to_csv.py

#!/usr/bin/env python3
"""Преобразование JSON в CSV с разворачиванием вложенных объектов."""
from __future__ import annotations

import argparse
import csv
import json
from pathlib import Path


def flatten(value, prefix: str = "", result: dict | None = None) -> dict:
    result = {} if result is None else result
    if isinstance(value, dict):
        for key, item in value.items():
            name = f"{prefix}.{key}" if prefix else str(key)
            flatten(item, name, result)
    elif isinstance(value, list):
        result[prefix] = json.dumps(value, ensure_ascii=False)
    else:
        result[prefix] = value
    return result


def main() -> int:
    parser = argparse.ArgumentParser(description="JSON в CSV")
    parser.add_argument("--input", type=Path, required=True, help="Исходный JSON")
    parser.add_argument("--output", type=Path, default=Path("data.csv"), help="Результат")
    parser.add_argument("--array-key", default="", help="Ключ с массивом записей")
    parser.add_argument("--delimiter", default=",", help="Разделитель колонок")
    parser.add_argument("--force", action="store_true", help="Перезаписать выходной файл")
    args = parser.parse_args()

    source = args.input.expanduser().resolve()
    target = args.output.expanduser().resolve()
    if not source.is_file():
        parser.error(f"Файл не найден: {source}")
    if source == target:
        parser.error("Выходной файл не должен совпадать с исходным")
    if target.exists() and not args.force:
        parser.error(f"Файл уже существует: {target}. Добавьте --force")
    if len(args.delimiter) != 1:
        parser.error("Разделитель должен состоять из одного символа")

    try:
        payload = json.loads(source.read_text(encoding="utf-8-sig"))
    except (OSError, json.JSONDecodeError) as error:
        parser.error(f"Не удалось прочитать JSON: {error}")

    if isinstance(payload, list):
        records = payload
    elif isinstance(payload, dict) and args.array_key:
        value = payload.get(args.array_key)
        if not isinstance(value, list):
            parser.error(f"Ключ {args.array_key} не содержит массив")
        records = value
    elif isinstance(payload, dict):
        records = [payload]
    else:
        parser.error("Ожидается массив или объект JSON")

    if not records:
        parser.error("В JSON нет записей")
    if any(not isinstance(record, dict) for record in records):
        parser.error("Каждая запись должна быть объектом")

    flat_records = [flatten(record) for record in records]
    columns: list[str] = []
    for record in flat_records:
        for key in record:
            if key not in columns:
                columns.append(key)

    target.parent.mkdir(parents=True, exist_ok=True)
    with target.open("w", encoding="utf-8", newline="") as handle:
        writer = csv.DictWriter(handle, fieldnames=columns, delimiter=args.delimiter, lineterminator="\n")
        writer.writeheader()
        for record in flat_records:
            row = {}
            for column in columns:
                value = record.get(column, "")
                if value is None:
                    value = ""
                elif isinstance(value, bool):
                    value = "true" if value else "false"
                row[column] = value
            writer.writerow(row)

    print(f"Записей: {len(flat_records)}")
    print(f"Колонок: {len(columns)}")
    print(f"Результат: {target}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get data-json-to-csv
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Данные и таблицы

CSV, JSON, SQLite, Excel, очистка, объединение и отчёты.