Основы Python

Чтение и запись JSON в Python

В этом уроке вы будете превращать строку JSON в словарь Python и обратно с помощью встроенного модуля json.

  • Начальный
  • Чтение: 2 мин
  • Примеров для запуска: 1

Введение

Какую задачу это решает

Программы постоянно обмениваются данными: веб-API присылает пользователя, файл настроек хранит параметры, другая программа ждёт ваши результаты. Им нужен общий текстовый формат, понятный обеим сторонам. JSON - такой формат, и Python должен уметь превращать его в словари и списки и обратно.

Пример из жизни

JSON похож на анкету, заполненную по стандартному образцу, который понимает любая контора. json.loads читает заполненную анкету и превращает её в данные Python, с которыми можно работать. json.dumps записывает ваши данные Python обратно по тому же образцу, чтобы их могла прочитать любая другая программа.

От стандартной анкеты к коду
json.loads(...)📥 Прочитать анкету в данные Python
user["score"] = 95🖊️ Добавить поле
json.dumps(user, indent=2)📤 Записать обратно по стандартному образцу
true🔤 true из JSON становится True в Python
На входе текст JSON, в работе значения Python, на выходе текст JSON.
Одним предложением

JSON - это текстовый формат данных. Модуль json превращает текст JSON в значения Python (json.loads), а значения Python - в текст JSON (json.dumps).

Главное

  1. json.loads(...) превращает текст JSON в словарь Python, и true из JSON становится True.
  2. user["score"] = 95 меняет данные, как любой другой словарь.
  3. json.dumps(user, indent=2) записывает их обратно как текст JSON с отступами, чтобы людям было удобно читать.
  4. В выводе True из Python снова записан как true в JSON.

Когда это нужно?

  • Чтение ответов веб-API и отправка им данных.
  • Сохранение настроек или небольших наборов данных в читаемом файле.
  • Передача данных между программами на разных языках.

Когда это не нужно

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

Пример кода

Запустить код →
main.py
import json

user = json.loads('{"name": "Ada", "active": true}')
user["score"] = 95

print(json.dumps(user, indent=2))
Получить кнопку запуска для этого примера

Результат выполнения

{
  "name": "Ada",
  "active": true,
  "score": 95
}

Разбор кода

Функция json.loads() читает строку JSON и возвращает словарь, в котором значение true из JSON становится True в Python. После добавления ключа score функция json.dumps() снова превращает словарь в строку JSON. Параметр indent=2 добавляет отступы, чтобы результат было легче читать.

Измените значения и запустите программу в онлайн-компиляторе Python CodeUtility без локальной установки Python.

Упражнения для практики

Попробуйте изменить код по подсказкам ниже. Если менять код и смотреть на результат, урок запомнится гораздо лучше, чем при простом чтении.

  1. Измените входные данные и предскажите результат до запуска.
  2. Добавьте проверку пустых или неверных данных.
  3. Вынесите обработку в отдельную функцию и проверьте её на нескольких наборах данных.
Запустить в компиляторе Python →

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

Путаница loads и load

loads читает строку, а load - открытый файл. Буква s означает string.

Ошибка
with open("user.json") as f:
    user = json.loads(f)
Исправление
with open("user.json") as f:
    user = json.load(f)

JSON с одинарными кавычками

JSON требует двойных кавычек вокруг ключей и строк.

Ошибка
json.loads("{'name': 'Ada'}")
Исправление
json.loads('{"name": "Ada"}')

Закончили этот урок?

Отметьте его как изученный, чтобы следить за прогрессом.

Далее: Классы и объекты в Python →

Попрактикуйтесь на задаче

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

Все задачи