json — Кодер и декодер JSON

Модуль json обеспечивает кодирование Python-объектов в строки JSON и декодирование JSON-строк в Python-объекты.

import json

Кодирование (Python → JSON)

import json

data = {
    "name": "Алиса",
    "age": 30,
    "languages": ["Python", "JavaScript"],
    "active": True,
    "address": None
}

# Преобразование в JSON-строку
json_str = json.dumps(data, ensure_ascii=False)

# Красивый вывод
json_pretty = json.dumps(data, indent=2, ensure_ascii=False)
print(json_pretty)

# Запись в файл
with open('data.json', 'w', encoding='utf-8') as f:
    json.dump(data, f, indent=2, ensure_ascii=False)

# Сортировка ключей
json.dumps(data, sort_keys=True, ensure_ascii=False)

Декодирование (JSON → Python)

import json

json_str = '{"name": "Алиса", "age": 30, "active": true}'

# Парсинг JSON-строки
data = json.loads(json_str)
print(data['name'])   # Алиса
print(type(data))     # <class 'dict'>

# Чтение из файла
with open('data.json', 'r', encoding='utf-8') as f:
    data = json.load(f)

Соответствие типов

Пользовательская сериализация

import json
from datetime import datetime

class DateTimeEncoder(json.JSONEncoder):
    def default(self, obj):
        if isinstance(obj, datetime):
            return obj.isoformat()
        return super().default(obj)

data = {"created": datetime.now()}
json.dumps(data, cls=DateTimeEncoder)
# '{"created": "2024-01-15T10:30:00"}'

# Быстрый способ через default
json.dumps(data, default=str)

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

• Одинарные кавычки — невалидный JSON — используйте только "двойные"
• Запятая в конце — невалидно — {"a": 1,} вызовет ошибку
• set, tuple не сериализуются — преобразуйте в list
• json.load и json.loads — load читает из файла, loads из строки
• ensure_ascii=False — нужен для кириллицы и других не-ASCII символов

Официальная документация

json — JSON encoder and decoder

Полный справочник API (API Reference)

Важные функции

Классы