Лоадика
ЛОАДИКАOnline Tools
Текст и символы

Как отформатировать JSON: пробелы, отступы и проверка

Как привести JSON в читаемый вид: отступы и пробелы, проверка синтаксиса, поиск ошибок и минификация. Онлайн-форматирование прямо в браузере.

JSON окружает нас повсюду: настройки приложений, ответы API, файлы конфигурации, выгрузки из сервисов. Проблема в том, что часто он приходит одной сплошной строкой, в которой невозможно ничего разобрать. Форматирование приводит данные в читаемый вид за секунду и заодно сразу показывает, есть ли в документе ошибки.

Зачем форматировать JSON

Синтаксису JSON отступы не нужны: одна строка без пробелов — совершенно валидный документ. Проблемы начинаются, когда файл нужно прочитать человеку или изменить вручную.

  • Читаемость: вложенные объекты и массивы видны с первого взгляда.
  • Правки: нужное поле легко найти, не задев соседние.
  • Сравнение версий: изменения в отформатированных файлах видны построчно.
  • Отладка: форматтер сразу укажет, где нарушен синтаксис.

Как устроены отступы и пробелы

Форматирование сдвигает каждый вложенный уровень на несколько пробелов вправо, и структура документа становится видна как схема. Общепринятые варианты — два или четыре пробела: выбирайте тот, что принят в вашей команде, и держитесь его во всех файлах. Кавычки в JSON всегда двойные, после двоеточия ставится один пробел, элементы массивов разделяются запятой и переносом строки.

Важно понимать: форматирование не меняет данные. Меняется только их представление — те же ключи и значения, просто расставленные по строкам. Поэтому отформатированный файл безопасно возвращать в приложение или отправлять в API.

Минификация: обратная сторона форматирования

Минификация сжимает документ в одну строку без пробелов и переносов. Так делают перед отправкой по сети и для экономии места: файл получается заметно меньше. Править минифицированный документ руками — мучение, поэтому храните читаемую версию, а сжимайте только копию для публикации.

Как найти ошибку в JSON

Валидатор — первый помощник в отладке. Вставьте текст в форматирование JSON: если в документе ошибка, инструмент покажет место, где синтаксис нарушился, — останется исправить конкретную строку, а не искать её по всему файлу.

Чаще всего документы ломают так:

  • Лишняя запятая после последнего элемента списка или объекта.
  • Одинарные кавычки вместо двойных.
  • Ключи без кавычек — в JavaScript это допустимо, в JSON нет.
  • Комментарии: в JSON их не существует.
  • Незакрытая скобка или кавычка в середине файла.

После исправления прогоните файл через форматтер ещё раз. Если сравниваете две версии конфигурации, поможет сравнение текстов — различия подсветятся построчно. Массовую замену одного значения на другое удобнее сделать через замену текста, чем править каждое вхождение вручную.

Пошаговая инструкция

  1. Скопируйте JSON в буфер обмена.
  2. Откройте инструмент форматирования JSON.
  3. Вставьте текст и запустите форматирование.
  4. Если появилась ошибка — исправьте указанное место и повторите.
  5. Скопируйте результат или скачайте готовый файл.

Инструмент работает в браузере: данные никуда не отправляются, поэтому форматировать можно и рабочие конфигурации с внутренними адресами.

Частые вопросы

Сколько пробелов ставить в отступе?

Два или четыре — оба варианта стандартны. Главное — одинаковый отступ во всём файле, иначе сравнение версий превращается в шум.

JSON и объект JavaScript — это одно и то же?

Синтаксис похож, но JSON строже: двойные кавычки, никаких комментариев, висячих запятых и функций.

Что делать, если файл огромный и править его тяжело?

Скорее всего, вы пытаетесь редактировать минифицированный документ. Сначала отформатируйте его — править станет заметно проще.

Форматирование — самая быстрая проверка JSON на валидность. Привычка прогонять файл через форматтер перед отправкой экономит минуты отладки и нервы коллегам.

Инструменты по теме

Пригодятся для задачи из статьи.