Fundamentos de Python

Ler e escrever JSON em Python

Nesta lição, você vai converter uma string JSON em dicionário Python e vice-versa com o módulo json da biblioteca padrão.

  • Iniciante
  • 2 min de leitura
  • 1 exemplo executável

Introdução

O problema

Programas trocam dados o tempo todo: uma API web envia um usuário, um arquivo de configuração guarda opções, outro programa espera os seus resultados. Para isso, os dois lados precisam de um formato de texto comum. JSON é esse formato, e o Python precisa convertê-lo em dicionários e listas, e também fazer o caminho de volta.

Pense assim

O JSON é como um formulário preenchido num modelo padrão que qualquer repartição consegue ler. json.loads lê o formulário preenchido e transforma em dados Python com que você pode trabalhar. json.dumps escreve seus dados Python de volta no mesmo modelo padrão, para que qualquer outro programa consiga ler.

Do formulário padrão ao código
json.loads(...)📥 Leia o formulário e transforme em dados Python
user["score"] = 95🖊️ Acrescente um campo
json.dumps(user, indent=2)📤 Escreva de novo no modelo padrão
true🔤 O true do JSON vira o True do Python
Entra texto JSON, você trabalha com valores Python, sai texto JSON.
Em uma frase

JSON é um formato de texto para dados. O módulo json converte texto JSON em valores Python (json.loads) e valores Python em texto JSON (json.dumps).

Pontos-chave

  1. json.loads(...) transforma o texto JSON em um dicionário Python, e o true do JSON vira True.
  2. user["score"] = 95 muda os dados como em qualquer outro dicionário.
  3. json.dumps(user, indent=2) escreve de volta como texto JSON, indentado para pessoas lerem.
  4. Na saída, o True do Python é escrito de novo como true do JSON.

Quando usar?

  • Ler respostas de APIs web e enviar dados para elas.
  • Guardar configurações ou pequenos conjuntos de dados em um arquivo legível.
  • Passar dados entre programas escritos em linguagens diferentes.

Quando não é preciso

  • Datas, sets ou as suas próprias classes: JSON não guarda isso direto, então converta antes para strings ou dicionários.
  • Tabelas enormes de números: CSV ou um banco de dados é menor e mais rápido.

Código de exemplo

Executar código →
main.py
import json

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

print(json.dumps(user, indent=2))
Gerar um botão Run para este exemplo

Resultado da execução

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

Explicação do código

A função json.loads() lê uma string JSON e retorna um dicionário, em que o valor true do JSON vira True no Python. Depois de adicionar a chave score, a função json.dumps() converte o dicionário de volta em string JSON. O parâmetro indent=2 recua o resultado para facilitar a leitura.

Altere os valores e execute o programa no compilador Python online CodeUtility sem instalar Python.

Exercícios práticos

Tente modificar o código seguindo as sugestões abaixo. Mudar o código e observar o resultado ajuda você a entender muito mais do que só ler.

  1. Mude os dados de entrada e tente prever o resultado antes de executar.
  2. Adicione uma verificação para dados vazios ou inválidos.
  3. Coloque a lógica em uma função separada e teste com vários conjuntos de dados.
Executar no compilador Python →

Erros comuns

Confundir loads e load

loads lê uma string; load lê de um arquivo aberto. O s vem de string.

Problema
with open("user.json") as f:
    user = json.loads(f)
Correção
with open("user.json") as f:
    user = json.load(f)

Escrever JSON com aspas simples

JSON exige aspas duplas em volta de chaves e strings.

Problema
json.loads("{'name': 'Ada'}")
Correção
json.loads('{"name": "Ada"}')

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.

Pratique com um desafio

Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.

Todos os desafios