Программирование

Что такое JSON: формат, синтаксис, чем открыть файл

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

Что такое JSON: формат, синтаксис, чем открыть файл
Фото: Sai Kiran Anagani _imkiran, CC0, Wikimedia Commons
Содержание
  1. JSON простыми словами
  2. Как выглядит JSON и из чего он состоит
  3. Типы данных в JSON
  4. Правила синтаксиса
  5. Чем открыть файл JSON
  6. Как работать с JSON в Python
  7. Ошибки JSON и как их найти
  8. Где встречается JSON и чем он отличается от XML и CSV

JSON простыми словами

Название расшифровывается как JavaScript Object Notation, то есть запись объектов в стиле JavaScript. Формат придумали для обмена данными между программами, а позже он стал независимым от языка: JSON понимают Python, C#, PHP, Java, Kotlin и десятки других. Описан он в стандартах ECMA-404 и RFC 8259, а кодировка файлов - UTF-8.

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

Как выглядит JSON и из чего он состоит

Данные в JSON строятся из двух структур. Объект - это набор пар ключ-значение в фигурных скобках. Массив - это упорядоченный список значений в квадратных скобках. Они вкладываются друг в друга сколько угодно раз. Вот пример небольшого файла.

{
  "name": "Анна",
  "age": 27,
  "student": false,
  "hobbies": ["плавание", "шахматы"],
  "address": {
    "city": "Казань",
    "zip": "420000"
  },
  "phone": null
}

Здесь корень - объект с шестью ключами. Ключ всегда строка в двойных кавычках, после него идёт двоеточие, а пары разделяются запятыми. Значение hobbies - массив из двух строк, address - вложенный объект, phone - пустое значение null. Отступы нужны только для чтения, программе они не важны.

Сравнение объекта и массива в JSON
Две основные структуры JSON: объект и массив

Типы данных в JSON

В JSON всего шесть видов значений. Других типов нет, поэтому, например, дату записывают строкой, а денежную сумму числом или строкой по договорённости между программами.

ТипПримерЗаметка
Строка"привет"Только двойные кавычки
Число42, -3.5, 1e3Без ведущих нулей, без NaN
Логическоеtrue, falseСтрочными буквами
ПустоеnullОзначает отсутствие значения
Массив[1, 2, 3]Значения любых типов
Объект{"a": 1}Ключи-строки

Внутри строк специальные символы экранируют обратной косой чертой: \" для кавычки, \\ для самого слеша, \n для переноса строки, \t для табуляции. Любой символ Юникода можно записать кодом вида \u041f, но в файле в UTF-8 кириллицу обычно оставляют как есть.

Правила синтаксиса

JSON строже, чем обычный JavaScript. Большинство ошибок в файлах возникает из-за нарушения нескольких простых правил.

  • Ключи и строки только в двойных кавычках, одинарные не допускаются.
  • После последнего элемента в объекте или массиве запятой нет.
  • Комментариев в стандартном JSON нет ни в виде // , ни в виде /* */.
  • Значения undefined, функции и даты как отдельный тип не существуют.
  • Корнем может быть объект, массив или одиночное значение, но на практике почти всегда объект.
  • Файл должен быть в UTF-8, лучше без метки BOM.

Некоторые программы, например VS Code для файлов настроек, разрешают комментарии и запятые в конце. Это расширение под названием JSONC, и обычные парсеры такой файл не примут.

Чем открыть файл JSON

Файл json - это обычный текст, поэтому подойдёт любая программа для работы с текстом. Если двойной щелчок открывает не то приложение, нажмите на файл правой кнопкой, выберите Открыть с помощью и укажите нужную программу.

ПрограммаЧто даёт
БлокнотБыстрый просмотр, ничего устанавливать не нужно
БраузерПеретащите файл в окно, Firefox показывает дерево данных
VS CodeПодсветка, сворачивание блоков, проверка ошибок
Notepad++Подсветка и плагины для форматирования

Если файл занимает одну длинную строку, вставьте его в редактор с функцией форматирования: в VS Code это сочетание Shift+Alt+F. Файлы размером в сотни мегабайт в Блокноте открываются тяжело, для них лучше взять специализированный просмотрщик или обработать данные программой. О том, как ставить такие инструменты, смотрите в разделе Windows и программы.

Как работать с JSON в Python

Для Python формат поддерживается стандартным модулем json, ставить ничего не нужно. Если интерпретатора ещё нет, сначала установите Python. Две основные пары функций: loads и dumps работают со строками, load и dump - с файлами.

import json

# Чтение файла в словарь
with open("data.json", encoding="utf-8") as f:
    data = json.load(f)

print(data["name"])        # Анна
print(data["hobbies"][0])  # плавание

# Изменение и запись обратно
data["age"] = 28
with open("out.json", "w", encoding="utf-8") as f:
    # ensure_ascii=False сохраняет кириллицу, indent=2 даёт отступы
    json.dump(data, f, ensure_ascii=False, indent=2)

При чтении объекты превращаются в словари, массивы в списки, true и false в True и False, null в None. Параметр encoding лучше указывать всегда: в версиях до 3.15 на Windows по умолчанию берётся кодировка системы, и кириллица может прочитаться неверно. Для разбора строки есть json.loads, для получения строки из данных - json.dumps.

В JavaScript и браузере то же делают JSON.parse и JSON.stringify, в C# - классы пространства имён System.Text.Json. Принцип везде одинаков: текст превращается в структуру данных и обратно.

Ошибки JSON и как их найти

Если программа пишет Unexpected token, JSON parse error или Expecting property name, значит файл нарушает синтаксис. Сообщение обычно содержит номер строки и позиции, с него и начинайте проверку. Чаще всего причины такие.

  1. Лишняя запятая после последнего элемента списка или объекта.
  2. Одинарные кавычки вместо двойных или ключи без кавычек.
  3. Пропущена запятая между двумя парами.
  4. Незакрытая скобка: число открывающих и закрывающих скобок должно совпадать.
  5. Комментарий внутри файла, оставленный при ручной правке.
  6. Метка BOM в начале файла или неверная кодировка, из-за чего кириллица превращается в набор странных символов.
Список типичных ошибок в файле JSON
Что проверить, если файл не открывается или не читается программой

Проще всего найти ошибку, открыв файл в VS Code: он подчёркивает проблемные места красным. В Python можно перехватить исключение json.JSONDecodeError, у которого есть атрибуты lineno и colno с точным положением ошибки. Для настроек, где встречаются цвета, удобно заранее подобрать значения в конвертере цветов.

Где встречается JSON и чем он отличается от XML и CSV

Вы сталкиваетесь с JSON чаще, чем кажется. В веб-разработке это основной формат ответов API: сервер присылает данные, а страница или приложение их показывает. Файлы package.json описывают проекты на Node.js, manifest.json - расширения браузеров и веб-приложения, settings.json хранит настройки VS Code, config.json - параметры самых разных программ.

ФорматСильная сторонаСлабая сторона
JSONКомпактный, вложенные данные, есть массивыНет комментариев и дат
XMLАтрибуты, схемы, пространства имёнМногословный
CSVПростая таблица, открывается в ExcelНет вложенности

Если данные табличные, например список товаров с ценами, удобнее CSV и Excel. Если структура сложная и вложенная, берите JSON. Для хранения настроек, которые правят вручную, иногда выбирают YAML или TOML из-за комментариев, а запускать команды перед обработкой файлов можно через BAT-файл.

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

JSON что это такое простыми словами?

Это текстовый формат записи данных в виде пар ключ-значение и списков. Он понятен и человеку, и программам, поэтому его применяют для настроек, обмена данными между сайтами и приложениями.

Чем открыть файл JSON на компьютере?

Подойдёт Блокнот, любой браузер, Notepad++ или VS Code. Для длинных файлов удобнее редактор с подсветкой и функцией форматирования, он же найдёт синтаксические ошибки.

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

Формат вырос из записи объектов JavaScript, но строже: нужны двойные кавычки у ключей, нет функций, комментариев и undefined. JSON можно использовать в любом языке, а не только в JavaScript.

Что значит ошибка JSON parse error?

Программа не смогла разобрать текст из-за нарушения синтаксиса. Проверьте запятые в конце списков, кавычки, парность скобок и кодировку UTF-8. Номер строки в сообщении подскажет, где искать.

Можно ли писать комментарии в JSON?

В стандартном JSON нельзя, парсер выдаст ошибку. Допускают их только расширенные варианты вроде JSONC в VS Code. Для пояснений заводят отдельное поле, например note.

Как открыть JSON в Excel?

В Excel на вкладке Данные выберите Получить данные - Из файла - Из JSON. Откроется редактор Power Query, где вложенные поля разворачивают в столбцы, а результат загружают на лист.

Нашли ошибку или устаревший пункт меню? Напишите на admin@programistik.top с адресом страницы. Перед правкой реестра, системных файлов и разделов диска делайте резервную копию.

Читайте по теме