Превратить JSON в CSV
Разворачивает массив JSON-объектов в плоскую таблицу CSV, включая вложенные поля.
Что делает скрипт
Скрипт принимает массив объектов, объект с массивом внутри или одиночный объект. Вложенные словари разворачиваются в колонки с точками, массивы сохраняются как 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 itemspython json_to_csv.py --input report.json --delimiter ';' --force
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.