Гайды по JSON
Обновлено
Гайды о том, на чём в JSON чаще всего спотыкаются: что такое JSON-файл и как его отформатировать, большие числа, которые меняют значение, ключи, которые меняются местами, комментарии, которых нет, одно значение на строку и YAML. В каждом — что на самом деле печатают парсеры и как получить нужный результат.
Все гайды по JSON
| Гайд | О чём |
|---|---|
| JSON: что это за формат и чем открыть файл | Что это за формат, что лежит в файле .json и чем его открыть: Windows, macOS, Linux, Android, iPhone, браузер или онлайн-просмотр. |
| Как отформатировать JSON: код, редакторы и онлайн | Форматирование JSON в Python, jq, JavaScript, Go и PowerShell, в VS Code, Notepad++, IntelliJ и Sublime Text или онлайн. |
| Большие числа в JSON: BigInt, точность и JSON.parse | Почему JSON.parse округляет 12345678901234567890 и теряет нуль в 1.10, что значит «Do not know how to serialize a BigInt» и как сохранить числа точно в JavaScript, Python, Go и Java. |
| Порядок ключей в JSON: почему числовые ключи встают первыми | Почему JavaScript переносит числовые ключи вперёд, почему сортировка ставит "10" перед "2" и когда порядок важен. |
| Комментарии в JSON: можно ли, JSONC, JSON5 и обходные пути | Почему в JSON нет комментариев, что разрешают JSONC и JSON5 и как оставить пометку в файле или убрать комментарии перед разбором. |
| JSON Lines и NDJSON: что это и как читать | Одно значение JSON на строку, почему json.load падает с «Extra data» и как читать и писать такие файлы в Python, JavaScript, Go и jq. |
| JSON или YAML: разница, ловушки и что выбрать | Синтаксис, комментарии, якоря, «проблема Норвегии» в YAML 1.1, числа и какой формат когда выбирать. |
Ошибки JSON и инструменты
Нужен разбор конкретного сообщения, например «Unexpected token» или «Expecting value»? В справочнике ошибок JSON каждая разобрана по причине, с точным текстом каждого парсера. Проверить документ прямо сейчас — в валидаторе, отформатировать — в форматировании.
Гайды по JSON: частые вопросы
Каким правилам JSON следуют гайды?
Строгому JSON по RFC 8259 — тем же правилам, что применяет валидатор. JSONC, JSON5 и JSON Lines разобраны как отдельные форматы, с тем, что каждый из них добавляет.
Почему один и тот же JSON выходит из разных инструментов по-разному?
Большинство инструментов разбирают текст в значения и печатают значения обратно. По дороге числа становятся double, объекты теряют порядок ключей, а комментарии превращаются в ошибки. Гайды показывают, где это происходит и как этого избежать.
Можно ли повторить примеры самому?
Да. У каждого примера указано, какой парсер и какой версии напечатал результат: его можно повторить в Node.js, Python, Go, Java или jq или вставить тот же JSON в форматирование и сравнить.