Как отформатировать JSON: пробелы, отступы и проверка
JSON окружает нас повсюду: настройки приложений, ответы API, файлы конфигурации, выгрузки из сервисов. Проблема в том, что часто он приходит одной сплошной строкой, в которой невозможно ничего разобрать. Форматирование приводит данные в читаемый вид за секунду и заодно сразу показывает, есть ли в документе ошибки.
Зачем форматировать JSON
Синтаксису JSON отступы не нужны: одна строка без пробелов — совершенно валидный документ. Проблемы начинаются, когда файл нужно прочитать человеку или изменить вручную.
- Читаемость: вложенные объекты и массивы видны с первого взгляда.
- Правки: нужное поле легко найти, не задев соседние.
- Сравнение версий: изменения в отформатированных файлах видны построчно.
- Отладка: форматтер сразу укажет, где нарушен синтаксис.
Как устроены отступы и пробелы
Форматирование сдвигает каждый вложенный уровень на несколько пробелов вправо, и структура документа становится видна как схема. Общепринятые варианты — два или четыре пробела: выбирайте тот, что принят в вашей команде, и держитесь его во всех файлах. Кавычки в JSON всегда двойные, после двоеточия ставится один пробел, элементы массивов разделяются запятой и переносом строки.
Важно понимать: форматирование не меняет данные. Меняется только их представление — те же ключи и значения, просто расставленные по строкам. Поэтому отформатированный файл безопасно возвращать в приложение или отправлять в API.
Минификация: обратная сторона форматирования
Минификация сжимает документ в одну строку без пробелов и переносов. Так делают перед отправкой по сети и для экономии места: файл получается заметно меньше. Править минифицированный документ руками — мучение, поэтому храните читаемую версию, а сжимайте только копию для публикации.
Как найти ошибку в JSON
Валидатор — первый помощник в отладке. Вставьте текст в форматирование JSON: если в документе ошибка, инструмент покажет место, где синтаксис нарушился, — останется исправить конкретную строку, а не искать её по всему файлу.
Чаще всего документы ломают так:
- Лишняя запятая после последнего элемента списка или объекта.
- Одинарные кавычки вместо двойных.
- Ключи без кавычек — в JavaScript это допустимо, в JSON нет.
- Комментарии: в JSON их не существует.
- Незакрытая скобка или кавычка в середине файла.
После исправления прогоните файл через форматтер ещё раз. Если сравниваете две версии конфигурации, поможет сравнение текстов — различия подсветятся построчно. Массовую замену одного значения на другое удобнее сделать через замену текста, чем править каждое вхождение вручную.
Пошаговая инструкция
- Скопируйте JSON в буфер обмена.
- Откройте инструмент форматирования JSON.
- Вставьте текст и запустите форматирование.
- Если появилась ошибка — исправьте указанное место и повторите.
- Скопируйте результат или скачайте готовый файл.
Инструмент работает в браузере: данные никуда не отправляются, поэтому форматировать можно и рабочие конфигурации с внутренними адресами.
Частые вопросы
Сколько пробелов ставить в отступе?
Два или четыре — оба варианта стандартны. Главное — одинаковый отступ во всём файле, иначе сравнение версий превращается в шум.
JSON и объект JavaScript — это одно и то же?
Синтаксис похож, но JSON строже: двойные кавычки, никаких комментариев, висячих запятых и функций.
Что делать, если файл огромный и править его тяжело?
Скорее всего, вы пытаетесь редактировать минифицированный документ. Сначала отформатируйте его — править станет заметно проще.
Форматирование — самая быстрая проверка JSON на валидность. Привычка прогонять файл через форматтер перед отправкой экономит минуты отладки и нервы коллегам.