HOWTO · Python

Copiar um Dicionário em Python

Entenda quando a atribuição cria um alias de dicionário, quando uma cópia rasa basta e quando usar uma cópia profunda para tornar os valores aninhados independentes.

Nesta página

Para criar um novo dicionário externo, use dict(source) ou source.copy(). Ambos fazem cópias rasas: os valores aninhados continuam compartilhados. Use copy.deepcopy(source) quando também precisar que os valores mutáveis aninhados sejam independentes. A atribuição com = não cria uma cópia. Para saber mais, consulte o tutorial de dicionários do Python e a documentação do módulo copy, em inglês.

Atribuir um dicionário cria um alias

Atribuir um dicionário vincula outro nome ao mesmo objeto. Alterações feitas no dicionário por qualquer um dos nomes ficam visíveis pelos dois. Atribuir um novo objeto a um dos nomes é diferente: esse nome passa a apontar para outro lugar, sem alterar o objeto nem o outro nome.

Este exemplo completo altera o dicionário compartilhado por meio de meal e, em seguida, atribui um novo dicionário a meal:

food = {"Fruit": "Orange", "Vegetable": "Lettuce"}
meal = food
meal["Fruit"] = "Banana"
print(food)
print(meal)
meal = {"Fruit": "Apple"}
print(food)
print(meal)
{'Fruit': 'Banana', 'Vegetable': 'Lettuce'}
{'Fruit': 'Banana', 'Vegetable': 'Lettuce'}
{'Fruit': 'Banana', 'Vegetable': 'Lettuce'}
{'Fruit': 'Apple'}

Os dois primeiros valores exibidos são iguais porque, nesse momento, ambos os nomes se referem ao mesmo objeto. Depois que um novo dicionário é atribuído a meal, somente esse nome aponta para o novo dicionário; food continua se referindo ao original. Essa diferença ajuda a entender por que alterar um valor por meio de um nome também afeta o outro, enquanto substituir uma variável não substitui o objeto referenciado pelo outro nome.

Variáveis Python apontando para o mesmo dicionário

Criar uma cópia rasa de um dicionário

O construtor dict() e o método copy() de um dicionário criam um novo dicionário externo. Atualizar ou remover uma entrada de nível superior nessa cópia não altera o original. Os dois dicionários ainda se referem às mesmas listas, aos mesmos dicionários aninhados ou a outros valores mutáveis; por isso, alterações nesses valores podem aparecer pelos dois nomes.

Aqui, by_constructor e by_method recebem, cada um, seu próprio dicionário externo. A lista aninhada é compartilhada, enquanto atribuir um novo valor à chave name afeta somente a cópia escolhida:

source = {"name": "Sherlock", "numbers": [1, 2, 3]}
by_constructor = dict(source)
by_method = source.copy()
by_constructor["name"] = "Holmes"
by_constructor["numbers"][1] = 4
print(source)
print(by_constructor)
print(by_method)
{'name': 'Sherlock', 'numbers': [1, 4, 3]}
{'name': 'Holmes', 'numbers': [1, 4, 3]}
{'name': 'Sherlock', 'numbers': [1, 4, 3]}

Escolha qualquer uma das formas de cópia rasa quando precisar de um dicionário externo independente e puder compartilhar os valores aninhados. Uma cópia rasa não copia recursivamente os objetos aninhados. Por exemplo, atribuir outro valor a by_constructor["name"] não altera o valor de name na origem, pois cada dicionário externo tem sua própria chave. Já uma alteração em um item de numbers aparece nos três dicionários exibidos, porque a própria lista é compartilhada. O mesmo vale quando um valor é outro dicionário: a cópia de nível superior mantém uma referência a esse dicionário interno. Se precisar isolar apenas um valor aninhado, você pode copiá-lo separadamente; use uma cópia profunda quando quiser tornar independente toda a estrutura aninhada.

Cópia rasa em Python mostrando um novo dicionário externo

Fazer uma cópia profunda de um dicionário aninhado

Quando os valores mutáveis aninhados também precisam ser copiados de forma independente, use copy.deepcopy(). Essa função copia recursivamente os objetos contidos, permitindo que o exemplo abaixo altere um item da lista e um valor do dicionário interno sem modificar o original. Isso é útil para dados aninhados que você pretende editar de forma independente; não é necessário quando a intenção é compartilhar os valores aninhados.

import copy

source = {
    "numbers": [1, 2, 3],
    "address": {"city": "Miami"},
}
independent = copy.deepcopy(source)
independent["numbers"][1] = 4
independent["address"]["city"] = "Lexington"
print(source)
print(independent)
{'numbers': [1, 2, 3], 'address': {'city': 'Miami'}}
{'numbers': [1, 4, 3], 'address': {'city': 'Lexington'}}

Uma cópia profunda é útil quando alterações posteriores não devem se propagar entre a estrutura de origem e uma cópia de trabalho, por exemplo, ao preparar configurações aninhadas para modificá-las separadamente. Ela também copia os contêineres aninhados, e não apenas o dicionário externo; por isso, tanto a lista quanto o mapeamento interno address permanecem inalterados acima. Em estruturas grandes, a cópia profunda pode levar mais tempo e consumir mais memória do que a rasa. Escolha-a conforme a necessidade de manter os objetos aninhados independentes. Objetos Python podem personalizar o comportamento de cópia, e alguns recursos não podem ser duplicados de forma significativa; ao trabalhar com esses objetos, consulte a documentação do módulo copy, em inglês.

A escolha prática depende de quais objetos devem ser compartilhados: a atribuição compartilha o dicionário inteiro, uma cópia rasa separa apenas o dicionário externo, e uma cópia profunda também separa os objetos aninhados. A documentação do módulo copy explica como as cópias rasas e profundas tratam objetos compostos e objetos com comportamento de cópia personalizado.