Руководство

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

Вставьте корректный JSON, выберите отступ и при необходимости включите сортировку ключей, затем запустите форматирование. По умолчанию используется отступ в 2 пробела, а некорректный JSON не форматируется.

Инструмент Форматирование JSON

Что делает форматирование JSON

JSON Beautifier помогает представить корректный JSON в читаемом виде: добавить отступы, разбить структуру на строки и при необходимости упорядочить ключи объектов. Это удобно перед проверкой конфигурации, просмотром ответа API или подготовкой фрагмента JSON для документации.

Вставьте текст JSON в поле ввода и выберите параметры оформления. Отступ по умолчанию составляет 2 пробела, но его можно изменить. Сортировка ключей отключена по умолчанию, поэтому исходный порядок ключей сохраняется, если отдельно не включить упорядочивание. Инструмент предназначен именно для форматирования JSON, а не для исправления синтаксических ошибок в повреждённом тексте.

Как отформатировать JSON

  1. Подготовьте текст JSON. Объект, массив, строки, числа, логические значения и null должны соответствовать синтаксису JSON. Если исходный текст уже записан в одну строку, это не проблема: форматирование добавит структуру за счёт отступов и переносов.

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

  3. Выберите размер отступа. Если особые требования не нужны, оставьте значение по умолчанию, равное 2 пробелам. Для вложенных объектов и массивов каждый следующий уровень будет выделен выбранным отступом.

  4. При необходимости включите сортировку ключей. В выключенном состоянии ключи объектов не упорядочиваются дополнительно. После включения они выводятся в отсортированном порядке. Используйте эту настройку, когда важна единообразная последовательность полей, а не сохранение порядка из исходного текста.

  5. Запустите форматирование и проверьте итоговый текст. При корректном JSON операция завершается успешно, а результат возвращается как отформатированный текст. Обратите внимание на строки, вложенные массивы и объекты: по ним проще заметить лишний уровень вложенности или неожиданное значение.

  6. Если операция завершилась неуспешно, проверьте исходник, а не только параметры отступа. Некорректный JSON не форматируется. Ищите пропущенную запятую, лишнюю запятую, незакрытую фигурную или квадратную скобку, неправильные кавычки вокруг ключа или строкового значения. После исправления вставьте текст снова и повторите действие.

Как читать результат и понимать ограничения

Успешный результат означает, что входной текст распознан как корректный JSON и представлен в отформатированном виде. Это не означает, что значения логически верны для вашего API или конфигурации: форматтер меняет представление структуры, а не проверяет смысл полей.

Размер отступа влияет на читаемость, но не меняет данные. Сортировка ключей меняет порядок их показа в объектах, поэтому сравнение с исходником лучше выполнять с учётом выбранной настройки. Если сортировка отключена, дополнительного упорядочивания ключей не происходит.

Кириллица и другие символы вне ASCII сохраняются в отформатированном выводе, а не заменяются escape-последовательностями. Это позволяет читать русские значения непосредственно в результате. При пустом или состоящем только из пробелов вводе успешный статус не означает, что получен JSON: содержимое для форматирования отсутствует, и инструмент сообщает об отсутствии ввода.

Для проверки результата сопоставьте скобки, уровни вложенности, имена ключей и значения с исходным текстом. Если нужен валидный JSON для дальнейшей передачи, сначала устраните синтаксическую ошибку и повторите операцию. Форматированный вид сам по себе не исправляет повреждённую структуру и не подтверждает бизнес-правила, типы данных, обязательность полей или ожидаемое поведение внешней системы.

Практический пример

Разработчик приводит компактный объект с русским значением к читаемому виду перед добавлением его в документацию.

Вставьте этот объект: {"имя":"Ольга","профиль":{"город":"Казань"}}. Оставьте отступ 2 пробела, не включайте сортировку ключей и запустите форматирование.

После успешной обработки появляется отформатированный текст JSON с двумя пробелами на уровень вложенности; русские символы в строковом значении сохраняются без замены escape-последовательностями.

Ограничения

  • Некорректный JSON не форматируется. Пустой или состоящий только из пробелов ввод обрабатывается успешно, но не даёт отформатированного содержимого и сопровождается диагностикой об отсутствии ввода.

Частые ошибки

  • Причина: в исходнике нарушен синтаксис JSON, например пропущена запятая или закрывающая скобка. Действие: исправьте структуру, кавычки и разделители, затем повторно вставьте текст и запустите форматирование.

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

Можно ли отформатировать JSON с ошибкой?

Да, если текст синтаксически корректен: операция завершится успешно и вернёт JSON с выбранными отступами. При ошибке синтаксиса форматирование не выполняется.

Какой отступ используется по умолчанию?

По умолчанию используется отступ в 2 пробела. При необходимости выберите другое значение в настройке отступа перед запуском форматирования.

Можно ли отсортировать ключи JSON?

Да, но только после включения соответствующей настройки: в этом случае ключи объектов выводятся в отсортированном порядке. Без включения сортировки дополнительного упорядочивания нет.

Инструмент

Форматирование JSON