# Гайды по JSON

> Прочитать гайды по JSON: большие числа и BigInt, порядок ключей, комментарии, форматирование, JSON Lines, JSON и YAML, что такое файл .json.

- Адрес: https://jsonstatham.dev/ru/guides/
- Язык: Русский (ru)
- Английская версия: https://jsonstatham.dev/guides.md
- Обновлено: 2026-11-08

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

## Все гайды по JSON

| Гайд | О чём |
| --- | --- |
| [JSON: что это за формат и чем открыть файл](https://jsonstatham.dev/ru/guides/what-is-json/) | Что это за формат, что лежит в файле `.json` и чем его открыть: Windows, macOS, Linux, Android, iPhone, браузер или онлайн-просмотр. |
| [Как отформатировать JSON: код, редакторы и онлайн](https://jsonstatham.dev/ru/guides/pretty-print-json/) | Форматирование JSON в Python, jq, JavaScript, Go и PowerShell, в VS Code, Notepad++, IntelliJ и Sublime Text или онлайн. |
| [Большие числа в JSON: BigInt, точность и JSON.parse](https://jsonstatham.dev/ru/guides/json-big-numbers/) | Почему `JSON.parse` округляет `12345678901234567890` и теряет нуль в `1.10`, что значит «Do not know how to serialize a BigInt» и как сохранить числа точно в JavaScript, Python, Go и Java. |
| [Порядок ключей в JSON: почему числовые ключи встают первыми](https://jsonstatham.dev/ru/guides/json-key-order/) | Почему JavaScript переносит числовые ключи вперёд, почему сортировка ставит `"10"` перед `"2"` и когда порядок важен. |
| [Комментарии в JSON: можно ли, JSONC, JSON5 и обходные пути](https://jsonstatham.dev/ru/guides/json-comments/) | Почему в JSON нет комментариев, что разрешают JSONC и JSON5 и как оставить пометку в файле или убрать комментарии перед разбором. |
| [JSON Lines и NDJSON: что это и как читать](https://jsonstatham.dev/ru/guides/json-lines/) | Одно значение JSON на строку, почему `json.load` падает с «Extra data» и как читать и писать такие файлы в Python, JavaScript, Go и jq. |
| [JSON или YAML: разница, ловушки и что выбрать](https://jsonstatham.dev/ru/guides/json-vs-yaml/) | Синтаксис, комментарии, якоря, «проблема Норвегии» в YAML 1.1, числа и какой формат когда выбирать. |

## Ошибки JSON и инструменты

Нужен разбор конкретного сообщения, например «Unexpected token» или «Expecting value»? В [справочнике ошибок JSON](https://jsonstatham.dev/ru/errors/) каждая разобрана по причине, с точным текстом каждого парсера. Проверить документ прямо сейчас — в [валидаторе](https://jsonstatham.dev/ru/validator/), отформатировать — в [форматировании](https://jsonstatham.dev/ru/).

## Гайды по JSON: частые вопросы

### Каким правилам JSON следуют гайды?

Строгому JSON по [RFC 8259](https://www.rfc-editor.org/rfc/rfc8259) — тем же правилам, что применяет [валидатор](https://jsonstatham.dev/ru/validator/). JSONC, JSON5 и JSON Lines разобраны как отдельные форматы, с тем, что каждый из них добавляет.

### Почему один и тот же JSON выходит из разных инструментов по-разному?

Большинство инструментов разбирают текст в значения и печатают значения обратно. По дороге числа становятся double, объекты теряют порядок ключей, а комментарии превращаются в ошибки. Гайды показывают, где это происходит и как этого избежать.

### Можно ли повторить примеры самому?

Да. У каждого примера указано, какой парсер и какой версии напечатал результат: его можно повторить в Node.js, Python, Go, Java или jq или вставить тот же JSON в [форматирование](https://jsonstatham.dev/ru/) и сравнить.
