Конвертировать JSON в CSV

Каждый вложенный ключ становится отдельной колонкой, путь склеивается через точку. Например, объект {"user": {"address": {"city": "Москва", "zip": "101000"}}} превратится в колонки user.address.city и user.address.zip. Глубина не ограничена. Разделитель пути можно поменять опцией key_separator (например, "__" для совместимости с Django ORM).

Массивы скаляров (строки, числа, bool) склеиваются через ; в одну ячейку: ["red","green","blue"] становится "red;green;blue". Массивы объектов сериализуются обратно в JSON-строку и кладутся в одну ячейку — потому что их структура произвольна и не сводится к колонкам без потерь. Если вам нужно "размножение строк" (один объект → N CSV-строк), используйте опцию explode_arrays=true.

UTF-8 with BOM добавляет в начало файла три байта 0xEF 0xBB 0xBF. Без них русский Excel при двойном клике открывает CSV в системной кодировке Windows-1251 и показывает кириллицу как кракозябры. С BOM Excel автоматически видит UTF-8 и корректно отрисовывает русский, греческий, китайский. На Linux и macOS BOM игнорируется большинством парсеров, поэтому совместимость не страдает.

По умолчанию ";" — потому что русский Excel в системной локали ru-RU считает запятую десятичным разделителем и не разбивает по ней колонки. Для англоязычной локали или для импорта в pandas / Postgres COPY используйте delimiter=",". Поддерживается также "\t" (TSV) и "|" (pipe). Все значения с разделителем внутри автоматически берутся в двойные кавычки по правилам RFC 4180.

Конвертер автоматически распознаёт обёртки: если корень — объект, мы ищем в нём первое значение типа array (часто это поля "data", "items", "results", "rows"). При желании путь можно задать явно через опцию path: например, path="response.data.users". Если массив не найден, объект целиком сплющивается в один ряд CSV — удобно для конфигов и одиночных записей.