Como adicionar e atualizar chaves em um dicionário Python

Aprenda como adicionar elementos ou atualizar pares de valores-chave em um dicionário Python. Explore colchetes, método de atualização e opções de operador de mesclagem.

Experimente esta solução no Editor

Visão geral

Adicionar e atualizar elementos em um dicionário é um conceito central no gerenciamento de estado, processamento de dados e atualizações de configuração. Como os dicionários Python são coleções mutáveis, você pode modificar facilmente suas chaves e valores de forma dinâmica durante a execução do programa, sem precisar recriar toda a estrutura.

A maneira mais simples de adicionar um par chave-valor é usando a sintaxe de atribuição de colchetes: `my_dict[key] = value`. Se a chave não existir, o Python a adiciona ao dicionário. Se a chave já existir, o Python sobrescreve seu valor antigo pelo novo.

Para atualizações em massa ou operações de fusão, Python fornece o método `.update()`, que aceita outro dicionário ou um iterável de pares chave-valor. Além disso, emPython 3.9+, você pode usar o operador de união de mesclagem `|` para mesclar dois dicionários em um novo, ou o operador de atualização `|=` para atualizar um dicionário no local.

Saída de código e execução

Este script demonstra adição, atualização e mesclagem de dicionários em Python.

update_dict.py

Experimente no Editor

profile = {"username": "sara", "level": 5}

# 1. Add new key-value pair using brackets
profile["verified"] = True
print("After adding key:", profile)

# 2. Update existing key using brackets
profile["level"] = 6
print("After updating key:", profile)

# 3. Add/Update multiple keys using update()
profile.update({"avatar": "cat.png", "level": 7})
print("After update():", profile)

# 4. Using the merge operator (Python 3.9+)
extra_info = {"location": "US"}
merged_profile = profile | extra_info
print("Merged profile:", merged_profile)

Saída terminal

After adding key: {'username': 'sara', 'level': 5, 'verified': True}
After updating key: {'username': 'sara', 'level': 6, 'verified': True}
After update(): {'username': 'sara', 'level': 7, 'verified': True, 'avatar': 'cat.png'}
Merged profile: {'username': 'sara', 'level': 7, 'verified': True, 'avatar': 'cat.png', 'location': 'US'}

Implementação passo a passo

Use a notação de colchetes my_dict['new_key'] = value para inserir um único novo elemento.
Chame my_dict.update(new_dict) para mesclar várias chaves e valores no local.
Use o | operador union emPython 3.9+ para combinar dicionários sem alterar os originais.

Perguntas frequentes

O que acontece se eu adicionar uma chave que já existe?

O valor antigo associado a essa chave é substituído silenciosamente pelo novo valor.

Posso adicionar uma chave com um valor de lista padrão se ela não existir?

Sim! Você pode usar my_dict.setdefault(key, []) ou usar defaultdict do módulo de coleções para automatizar a inicialização do valor padrão.

Tópicos Relacionados

Como criar um dicionário em Python

Aprenda como criar um dicionário em Python. Entenda a sintaxe literal, o construtor de dict, as compreensões de dict e os inicializadores de valores-chave.

Como iterar por meio de um dicionário em Python

Aprenda como fazer loop ou iterar em um dicionário Python. Descubra métodos para fazer loop em chaves, valores e pares de valores-chave com exemplos limpos e executáveis.

Recursos Python recomendados

Expanda seu conhecimento com tutoriais interativos relacionados, folhas de dicas e comparações de código.

Tutorial Python

Geradores Python

Aprenda como usar geradores Python e instruções de rendimento para processar grandes conjuntos de dados com consumo mínimo de memória. Expressões do gerador mestre.

Ver recurso

Folha de dicas

Folha de referências dos métodos do dicionário Python

Aprenda métodos de dicionário Python. Guia de referência completo para inserções, recuperações, atualizações e verificações de pares de valores-chave.

Ver recurso

Comparação de idiomas

Decoradores Python versus padrão de design de decorador: as principais diferenças

Compare os decoradores Python e o padrão de design clássico do decorador. Entenda as diferenças entre o agrupamento de funções em tempo de definição e a composição dinâmica de objetos em tempo de execução com código executável.

Ver recurso