JSON formatter: как быстро найти ошибку в структуре

JSON formatter помогает быстро найти ошибку в структуре: вы вставляете «кашу» из одной строки, получаете отступы по уровням и сразу видите, где парсер споткнулся. Чаще всего ломают лишняя или забытая запятая, кавычки, незакрытая скобка и хвост после последнего поля. Откройте JSON formatter на Тулси: режим «Красиво» разложит объект по строкам, «Сжать» уберёт пробелы. Если синтаксис неверный, инструмент покажет сообщение об ошибке вместо результата. Обработка идёт в браузере на вашем устройстве, без отправки текста на сервер. Ниже: почему JSON ломается, что проверить глазами до вставки, путь в инструменте и соседние текстовые утилиты вроде Base64 и кодирования URL. Частые вопросы собраны в конце.

Почему в JSON появляется ошибка

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

Люди ищут «json formatter», чтобы починить конкретный кусок: вставить, развернуть, увидеть, где синтаксис не сходится. Соседний запрос «проверить json» ведёт туда же: сначала валидность, потом смысл полей.

Типичные источники поломки: ручное редактирование в блокноте; склейка двух объектов без запятой; копирование из лога с обрезанным хвостом; вставка с «умными» кавычками из Word или мессенджера.

Где ломается чаще всего

Вложенность. Объект внутри массива, массив внутри объекта: глаз теряет пару скобок { } и [ ]. На одной строке сломанную пару почти не видно. После разворота с отступами уровни встают в колонки, и незакрытая ветка бросается в глаза.

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

Что formatter не исправит сам

Смысл данных. Если ключ price содержит строку вместо числа, а сервер ждёт число, синтаксис может пройти, а логика всё равно сломается. Formatter проверяет структуру записи, не правила предметной области.

Чужой формат. XML, YAML, кусок JavaScript с комментариями и функциями: это уже не чистый JSON. Парсер честно скажет «не JSON». Сначала уберите комментарии и приведите кавычки к стандарту.

Что можно сделать самому до браузера

Иногда достаточно редактора, в котором вы уже сидите. Держите в голове два пути: локальный файл и вкладка на сайте.

В VS Code и похожих редакторах есть встроенное форматирование документа и подсветка синтаксиса. Если файл уже сохранён как .json, редактор часто сам подчеркнёт проблемное место. Для куска из чата или тикета путь длиннее: сначала сохранить файл, потом править.

На глаз в одной строке на тысячу символов почти всегда пропустите запятую. Formatter нужен как увеличительное стекло: сначала развернуть, потом править.

Проверка в редакторе кода

Откройте файл, запустите команду форматирования (в VS Code обычно через палитру команд). Если документ невалидный, форматирование не применится или редактор покажет диагностику. Сверьте номер строки с сообщением.

Для одноразового куска из почты быстрее вставить текст в formatter на Тулси: установка и сохранение файла не нужны.

Когда хватит глаз и двух скобок

Короткий объект на три поля можно сверить вручную: каждая { закрыта }, ключи в двойных кавычках, между полями запятые. Если сомневаетесь хотя бы в одном месте, вставляйте в инструмент. Экономия двух минут не стоит часа поиска висячей запятой в логе.

Как подготовить строку перед вставкой

Качество проверки зависит от того, что вы скопировали. Обрезанный хвост даёт ложную ошибку «в конце файла», хотя на сервере всё было целое.

Копируйте полный ответ: от первой { или [ до последней парной скобки. Не берите префикс лога вроде времени и уровня INFO. Не оставляйте в хвосте пояснение «// пример»: комментарии в JSON запрещены.

Если текст пришёл в Base64 или в закодированном виде для ссылки, сначала декодируйте. Для этого рядом на Тулси есть Base64 и URL encode.

Откуда брать исходник

Из DevTools сети: тело ответа скопируйте целиком. Из файла конфига: откройте исходник, не скриншот терминала. Из таблицы или выгрузки: убедитесь, что экспорт действительно JSON, а не CSV с расширением .json.

Из мессенджера: проверьте «умные» кавычки «» и “”. Их нужно заменить на обычные ". Иначе парсер споткнётся на первом ключе.

Частые ошибки подготовки

Вставили два JSON подряд без массива-обёртки. Вставили объект, а потом ещё текст «ok» после закрывающей скобки. Скопировали только середину большого массива. В каждом случае formatter честно ругается: сначала почините границы фрагмента, потом ищите запятые внутри.

Перед вставкой можно глянуть длину куска в счётчике символов: если строка внезапно короче обычного ответа API, вероятно, обрезали при копировании.

Как пройти путь в JSON formatter на Тулси

Откройте JSON formatter. Вставьте текст в верхнее поле. Выберите режим «Красиво» или «Сжать».

«Красиво» разберёт объект и выведет его с отступами. Так проще читать вложенность и править руками. «Сжать» уберёт пробелы и переносы: удобно для передачи в конфиг или тело запроса, где важна компактность.

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

Режим «Красиво»

Используйте его для поиска ошибки и для чтения. После успешного разбора пробегитесь глазами по уровням: каждый блок сдвинут относительно родителя. Ищите «дыру» в отступах или место, где ветка обрывается раньше времени.

Скопируйте красивый вариант в редактор, если нужно отдать коллеге читаемый конфиг. Для передачи на сервер строку часто снова сжимают.

Режим «Сжать»

Нужен, когда строка должна быть однострочной: параметр в адресе (после отдельного кодирования), поле в форме, компактное тело запроса. Сначала убедитесь, что JSON валиден в режиме «Красиво», затем переключите на «Сжать» и скопируйте.

Не сжимайте заведомо битый текст: ошибка останется, только читать её станет ещё труднее.

Как проверить результат и что делать при ошибке

Успех: справа аккуратный объект или одна сжатая строка, сообщение об ошибке пустое. Скопируйте результат и вставьте обратно в систему, откуда взяли исходник.

Неудача: красное или акцентная подсказка про невалидный JSON. Вернитесь к исходнику. Проверьте пары скобок, кавычки, запятые, отсутствие комментариев. Упростите тест: оставьте один маленький объект { "a": 1 }. Если он проходит, наращивайте куски, пока ошибка не проявится.

Сравните две версии конфига, если правили долго: вставьте «было» и «стало» в сравнение текстов и найдите, какая правка сломала синтаксис. Разбор сравнения: как сравнить два текста.

Данные на Тулси в этом инструменте не уходят на сервер: разбор идёт на устройстве. Для черновиков API и локальных конфигов этого обычно достаточно.

Смежные задачи рядом с JSON

После починки структуры часто нужно другое преобразование той же строки.

Если JSON лежит внутри Base64 (токен, вложение, поле в письме), сначала декодируйте Base64, затем снова откройте formatter. Если фрагмент едет в адресе страницы, пробелы и спецсимволы прогоните через кодирование для ссылок.

Лимит длины для поля формы или лога удобно смотреть в счётчике слов и символов. Как считать знаки с пробелами и без: как посчитать символы в тексте.

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

Что такое JSON formatter и зачем он нужен?

JSON formatter приводит текст формата JSON к читаемому виду с отступами или сжимает его в одну строку. Главная польза при ошибке: вы видите уровни вложенности и быстрее находите сломанное место. На Тулси это делает страница JSON formatter. Без разворота одна длинная строка почти не читается глазами.

Есть ли JSON formatter online в браузере без установки?

Да. Откройте formatter во вкладке, вставьте текст и получите результат. Регистрация для обычной проверки не нужна. Установка программы имеет смысл, если вы правите JSON каждый день в одном редакторе; для разового куска из тикета хватает браузера.

Как проверить JSON на ошибки?

Вставьте полный фрагмент в JSON formatter и включите «Красиво». Если парсер не смог разобрать текст, увидите сообщение об ошибке. Если разбор прошёл, синтаксис в порядке: дальше проверяйте смысл полей уже по документации API. Запросы вроде «json проверить на ошибки» и «проверить валидность json» как раз про этот шаг.

Как проверить валидность JSON в файле?

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

Что значит «неверный формат JSON»?

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

JSON formatter скачать или пользоваться в браузере?

Для разовых проверок скачивать ничего не нужно: вкладка на Тулси обрабатывает текст на устройстве. Скачивание имеет смысл, если корпоративная политика запрещает вставку данных во внешние страницы или вы хотите офлайн-плагин редактора. Тогда используйте локальный VS Code или аналог с проверкой .json.

Чем JSON formatter отличается от validator?

На практике это один цикл: валидатор отвечает «годится / нет», formatter ещё и переписывает вид. На Тулси при успехе вы получаете красивый или сжатый текст, при ошибке видите отказ разобрать. Отдельный «json formatter validator» как два разных окна обычно не нужен.

Как сделать из каши красивый JSON?

Вставьте строку в formatter, выберите «Красиво», скопируйте результат. Если ничего не появилось, сначала почините синтаксис. Пример минимального объекта: { "name": "demo", "ok": true }. После успеха наращивайте поля и вложенность.

Как сжать JSON в одну строку?

Сначала добейтесь успешного разбора в режиме «Красиво», затем переключите на «Сжать» и скопируйте вывод. Так вы не потеряете ошибку внутри нечитаемой простыни. Сжатый вид удобен для тела запроса и компактных конфигов; для отладки снова возвращайтесь к отступам.

Можно ли пользоваться форматтером в VS Code вместо сайта?

Да. В VS Code есть форматирование JSON и подсказки по синтаксису; запросы вроде «vs code json formatter» как раз про это. Сайт удобнее, когда кусок пришёл из чата и сохранять файл лень. Оба пути решают одну задачу: быстро увидеть структуру и место ошибки.

Если нужно сразу декодировать строку или уложить её в ссылку, откройте Base64 или URL encode. Для сверки двух версий конфига подойдут сравнение текстов и статья как сравнить два текста.