HOWTO · Python

Alterar a chave em um dicionário em Python

Aprenda a renomear uma ou várias chaves de um dicionário Python mantendo os seus valores.

Nesta página

Para renomear uma chave em um dicionário Python, atribua o valor dela à nova chave e, em seguida, remova a antiga. Use dict.pop() quando quiser recuperar o valor e remover a entrada antiga em uma única operação. Para várias alterações ou mudanças condicionais, crie um novo dicionário a partir de um mapeamento de chaves antigas para novas. Essas abordagens mantêm os valores associados; escolha conforme queira atualizar o dicionário original ou criar um resultado separado.

Alterar uma chave atribuindo seu valor a uma nova chave e excluindo a antiga

Uma chave de dicionário não pode ser editada diretamente. Para uma renomeação simples, leia o valor usando a chave antiga, atribua-o à nova chave e exclua a entrada antiga:

fruit = {"A": "Apple", "B": "Banana"}
fruit["C"] = fruit["B"]
del fruit["B"]
print(fruit)

Isso altera B para C e mantém o valor "Banana". A operação atualiza o próprio dicionário fruit. Se C já existir, a atribuição substituirá o valor atual. Portanto, quando isso for relevante para seus dados, verifique se a chave de destino está disponível.

Alterar uma chave com dict.pop()

dict.pop() remove a chave indicada e retorna seu valor. Você pode atribuir esse valor diretamente à chave substituta:

person = {"first_name": "John", "last_name": "Doe", "age": 30}
person["given_name"] = person.pop("first_name")

Após a atribuição, person contém given_name com o valor que antes estava associado a first_name. Assim como na atribuição direta, um valor existente em given_name será substituído. Se a chave antiga puder estar ausente, passe um valor padrão para pop, como em person.pop("first_name", None); caso contrário, chamar o método para uma chave inexistente gera KeyError.

Alterar uma ou mais chaves reconstruindo um dicionário

Para renomeações múltiplas ou condicionais, mapeie cada chave antiga para a substituta e use uma compreensão de dicionário. As chaves que não estiverem no mapeamento permanecem iguais:

original = {"a": 1, "b": 2, "c": 3}
key_mapping = {"a": "alpha", "b": "beta"}
renamed = {key_mapping.get(key, key): value for key, value in original.items()}

Neste exemplo, renamed contém alpha, beta e c com seus valores originais. A compreensão cria um novo dicionário, então original continua disponível sem essas alterações. Se duas chaves de origem forem mapeadas para a mesma chave de destino, o valor atribuído por último durante a compreensão substituirá o anterior. Se todos os valores precisarem ser mantidos, garanta que o mapeamento gere chaves distintas. Essa abordagem é especialmente útil quando a renomeação depende de uma regra aplicada a todas as chaves ou quando várias chaves conhecidas precisam ser alteradas de uma vez. Antes de reconstruir o dicionário, confira se há chaves de origem que possam convergir para o mesmo nome.

Esse método também permite transformações condicionais: substitua key_mapping.get(key, key) por uma expressão que retorne a chave desejada para cada item. A expressão deve ser determinística para os dados processados, e as chaves resultantes precisam ser hashable, como toda chave de dicionário.

Renomear colunas de um DataFrame quando as chaves do dicionário representam dados tabulares

Quando as chaves do dicionário são nomes de colunas de um conjunto de dados tabular, use DataFrame.rename(columns=...) para renomeá-las. Criar um DataFrame a partir de um dicionário não renomeia as chaves do dicionário original; cria um objeto tabular separado. Por exemplo, a operação pode ser escrita como df = df.rename(columns={"a": "alpha"}). Ela retorna um DataFrame com a coluna renomeada e mantém o dicionário de origem inalterado. Se precisar de um dicionário a partir do resultado, escolha uma orientação explícita, como df.to_dict(orient="list") quando os valores forem listas de colunas. Essa operação específica do Pandas requer que o Pandas esteja disponível no ambiente. Para dicionários comuns, as abordagens integradas com atribuição, dict.pop() ou compreensão evitam converter a estrutura de dados e geralmente são mais simples.