Fundamentos de Python

Mesclar dicionários em Python

Nesta lição, você vai juntar dois dicionários com o operador | e entender qual valor é mantido quando os dois têm a mesma chave.

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

Introdução

O problema

Configurações muitas vezes vêm de vários lugares: os padrões do programa e, por cima, as escolhas do próprio usuário. Você precisa de um resultado combinado em que as escolhas do usuário vencem, sem mudar os padrões que outros usuários ainda precisam.

Pense assim

Juntar dicionários é como colar uma folha de adesivos sobre um formulário impresso. Onde o adesivo cobre um campo, você vê o valor do adesivo. Onde não há adesivo, aparece o que está impresso. O formulário por baixo não é danificado.

De adesivos em um formulário ao código
defaults📄 O formulário impresso
preferences🏷️ Os adesivos por cima
defaults | preferences👀 O que você vê: os adesivos vencem onde se sobrepõem
"language": "vi"🔁 O adesivo esconde o en impresso
Chaves nos dois: o lado direito vence. Os originais não mudam.
Em uma frase

O operador | junta dois dicionários em um novo; quando uma chave está nos dois, fica o valor do dicionário da direita.

Pontos-chave

  1. defaults | preferences cria um dicionário novo; nem defaults nem preferences mudam.
  2. "language" está nos dois, então o valor do lado direito, "vi", vence.
  3. "theme" vem só de defaults e "font_size" só de preferences, então os dois são mantidos.
  4. Para mudar o próprio defaults, use defaults.update(preferences) ou defaults |= preferences.

Quando usar?

  • Aplicar as configurações do usuário por cima das configurações padrão.
  • Combinar configurações de um arquivo, de variáveis de ambiente e de opções da linha de comando.
  • Atualizar um registro só com os campos que mudaram.

Quando não é preciso

  • Configurações aninhadas (um dicionário dentro de outro): | substitui o dicionário interno inteiro em vez de juntar.
  • Python anterior ao 3.9, que não tem | para dicionários: use {**defaults, **preferences}.

Veja como funciona

Digite uma chave e guarde ou procure. O Python calcula o hash da chave para achar sua posição direto, sem percorrer todas as entradas.

Código de exemplo

Executar código →
main.py
defaults = {"theme": "dark", "language": "en"}
preferences = {"language": "vi", "font_size": 16}

settings = defaults | preferences
print(settings)
Gerar um botão Run para este exemplo

Resultado da execução

{'theme': 'dark', 'language': 'vi', 'font_size': 16}

Explicação do código

O operador | (disponível desde o Python 3.9) cria um novo dicionário com todas as chaves dos dois lados, e os dicionários originais não são alterados. Para uma chave repetida como language, o valor do dicionário da direita substitui o da esquerda, então o resultado é "vi" e não "en".

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

Colocar os dicionários na ordem errada

O lado direito vence. Os padrões precisam vir primeiro.

Problema
settings = preferences | defaults  # defaults overwrite the user
Correção
settings = defaults | preferences

Mudar os padrões sem querer

update() muda o dicionário no lugar, então o próximo usuário começa com os padrões errados.

Problema
defaults.update(preferences)
settings = defaults
Correção
settings = defaults | preferences

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