Ir al contenido principal

Anexar al diccionario Python: Cómo añadir pares clave-valor

Aprende a añadir pares clave-valor en un diccionario Python utilizando métodos como la notación entre corchetes, .update() para adiciones masivas y .setdefault() para inserciones condicionales.
Actualizado 6 ago 2025  · 8 min de lectura

En la programación Python, los diccionarios son increíblemente versátiles, ya que permiten almacenar datos en pares clave-valor para una gestión y un acceso eficientes. Si eres nuevo en Python, es importante que comprendas cómo manipular estos diccionarios, ya que mejorará enormemente tu forma de manejar los datos en diversas aplicaciones. Tanto si estás configurando ajustes, gestionando conjuntos de datos complejos o simplemente almacenando datos para consultarlos rápidamente, los diccionarios son la solución.

Una de las operaciones clave que tendrás que realizar con frecuencia es añadir elementos a un diccionario. Este artículo te guiará a través de diferentes métodos para añadir elementos a un diccionario en Python, desde la notación básica con corchetes hasta técnicas más avanzadas como el uso del método update() y el operador de fusión. 

Si eres nuevo en el concepto de diccionarios en Python, considera leer también nuestro Tutorial de diccionarios en Python o nuestro Tutorial de comprensión de diccionarios en Python, que son excelentes recursos para aprender sobre pares clave-valor y otras ideas fundamentales para los diccionarios. Además, nuestra hoja de referencia rápida Introducción a Python puede resultarte útil como referencia rápida si necesitas refrescar la sintaxis y las funciones de Python.

Respuesta rápida: Cómo añadir elementos a un diccionario en Python

Si estás buscando una solución rápida para añadir elementos a un diccionario Python, el método update() es uno de los más comunes y fáciles de usar:

# Initial dictionary with information for one person
people_info = {
    'person_1': {
        'name': 'Alice',
        'city': 'New York'
    }
}

# Updating Alice's information and adding another person
people_info.update({
    'person_1': {
        'name': 'Alice',
        'city': 'Los Angeles',  # Updated city
        'age': 30               # Added new detail
    },
    'person_2': {
        'name': 'Bob',
        'city': 'San Francisco'
    }
})

print(people_info)

# {
#     'person_1': {'name': 'Alice', 'city': 'Los Angeles', 'age': 30},
#     'person_2': {'name': 'Bob', 'city': 'San Francisco'}
# }

En este ejemplo, el método update() actualiza la información de Alice bajo la clave 'person_1', cambiando su city a 'Los Angeles' y añadiendo un nuevo detalle age: 30. También añade una nueva persona, Bob, bajo la clave 'person_2'.

Comprender los diccionarios de Python

Para empezar, podemos hablar sobre los diccionarios de Python y por qué son tan importantes en programación.

¿Qué es un diccionario Python?

Un diccionario en Python es una colección de pares clave-valor. Cada clave de un diccionario es única y se asigna a un valor, que puede ser de cualquier tipo de datos (como cadenas, números enteros, listas o incluso otros diccionarios). Esta estructura permite recuperar, añadir y modificar datos. Aquí tienes un ejemplo sencillo de un diccionario Python:

# Example of a dictionary
person = {
    'name': 'Alice',
    'age': 25,
    'city': 'New York'
}

# Accessing a value
print(person['name'])  # Output: Alice

En este ejemplo, 'name', 'age'y 'city' son claves, y 'Alice', 25, y 'New York' son sus valores correspondientes.

Estructura de un diccionario Python

Los diccionarios son colecciones desordenadas, lo que significa que los elementos no tienen un orden definido. Sin embargo, a partir de Python 3.7, los diccionarios mantienen el orden de inserción, lo que puede resultar útil en diversas aplicaciones. Aquí tienes un ejemplo más detallado para ilustrar la estructura:

# A more complex dictionary
employee = {
    'id': 101,
    'name': 'John Doe',
    'age': 30,
    'department': 'Engineering',
    'skills': ['Python', 'Machine Learning', 'Data Analysis'],
    'address': {
        'street': '123 Main St',
        'city': 'San Francisco',
        'state': 'CA',
        'zip': '94105'
    }
}

# Accessing nested data
print(employee['skills'][1])  # Output: Machine Learning
print(employee['address']['city'])  # Output: San Francisco

En este ejemplo, el diccionariode empleados contiene varios tipos de datos, incluida una lista ('skills') y otro diccionario ('address'). Esto demuestra cómo se pueden utilizar los diccionarios para almacenar y organizar estructuras de datos complejas.

Ahora que ya hemos cubierto los conceptos básicos, exploremos con más detalle los distintos métodos para añadir elementos a un diccionario.

Métodos para añadir elementos a un diccionario en Python

Añadir elementos a un diccionario es una tarea habitual en Python, y hay varios métodos para hacerlo, cada uno con sus propios casos de uso y ventajas. Repasemos uno por uno.

Uso de la notación entre corchetes

La forma más sencilla de añadir un único par clave-valor a un diccionario es utilizando la notación entre corchetes. Este método es sencillo y eficaz para añadir elementos individuales. Aquí está el código de syntax:

dictionary[key] = value

Aquí tienes un ejemplo utilizando la notación con corchetes:

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Add a new key-value pair
my_dict['city'] = 'New York'

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York'}

Este método añade o actualiza directamente el par clave-valor en el diccionario. Si la clave ya existe, se actualizará su valor.

Cuando utilizas la notación entre corchetes para añadir una clave que ya existe en el diccionario, se actualiza el valor asociado a esa clave. Esto puede ser tanto una ventaja como un inconveniente, dependiendo de tus necesidades. A continuación se muestra un ejemplo que ilustra cómo gestionar las claves existentes:

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Add a new key-value pair
my_dict['city'] = 'New York'

# Update an existing key-value pair
my_dict['age'] = 30

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 30, 'city': 'New York'}

En este ejemplo, el valor de la clave 'age' se actualiza de 25 a 30.

Usando el método .update()

El método .update() te permite añadir varios pares clave-valor a un diccionario de una sola vez. Puede aceptar otro diccionario o un iterable de pares clave-valor. Aquí está el impuesto sobre el agua.sintaxis:

dictionary.update(other)

Aquí tienes un ejemplo utilizando el .update() método:

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Add new key-value pairs using update()
my_dict.update({'city': 'New York', 'email': 'alice@example.com'})

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

El método .update() también se puede utilizar con un iterable de pares clave-valor. Aquí tienes un ejemplo:

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Add new key-value pairs using update() with an iterable
my_dict.update([('city', 'New York'), ('email', 'alice@example.com')])

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

El método .update() es especialmente útil cuando necesitas actualizar el diccionario con varias entradas nuevas simultáneamente. Si ya existe una clave, se actualizará su valor.

Usando el método .setdefault()

El método .setdefault() se utiliza para añadir un par clave-valor a un diccionario solo si la clave aún no existe. Si la clave existe, devuelve el valor existente. Aquí está el impuesto sobre el agua.sintaxis:

dictionary.setdefault(key, default_value)

Aquí tienes un ejemplo utilizando el .setdefault() método:

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Use setdefault to add a new key-value pair
my_dict.setdefault('city', 'New York')

# Attempt to add an existing key
my_dict.setdefault('age', 30)

# Print the updated dictionary
print(my_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York'}

En este ejemplo, el método .setdefault() añade la clave 'city' con el valor 'New York', ya que aún no existía en el diccionario. Al intentar añadir la clave 'age', no cambia el valor existente 25 porque la clave ya existe.

Este enfoque es adecuado cuando necesitas asegurarte de que una clave tenga un valor predeterminado si no existe. También se puede utilizar cuando deseas añadir nuevos pares clave-valor sin sobrescribir los existentes.

Uso del constructor dict()

También puedes crear un nuevo diccionario con pares clave-valor adicionales utilizando el constructor dict(). Este enfoque es útil cuando deseas crear un nuevo diccionario basado en uno ya existente. Aquí está el impuesto sobre el agua.sintaxis:

new_dict = dict(existing_dict, key1=value1, key2=value2)

Aquí tienes un ejemplo utilizando el dict() constructor:

# Initialize a dictionary
my_dict = {'name': 'Alice', 'age': 25}

# Create a new dictionary with additional key-value pairs
new_dict = dict(my_dict, city='New York', email='alice@example.com')

# Print the new dictionary
print(new_dict)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

En este ejemplo, se utiliza el constructor dict() para crear un nuevo diccionario new_dict que incluye los pares clave-valor originales de my_dict y los pares clave-valor adicionales 'city': 'New York' y 'email': 'alice@example.com'.

Este enfoque es adecuado cuando deseas crear un nuevo diccionario combinando diccionarios existentes y pares clave-valor adicionales. También se puede utilizar cuando necesitas crear un nuevo diccionario con algunas modificaciones, pero manteniendo el diccionario original sin cambios.

Tabla comparativa

Aquí tienes una tabla de referencia rápida con los métodos que hemos visto en este tutorial:

Método Caso de uso Ejemplo
Corchete Par clave-valor único dict[clave] = valor
.update() Múltiples pares clave-valor dict.update({clave1: valor1, clave2: valor2})
.setdefault() Añadir el par clave-valor solo si la clave no existe dict.setdefault(clave, valor_predeterminado)
constructor dict() Crea un nuevo diccionario o actualiza uno existente con pares clave-valor adicionales. new_dict = dict(existing_dict, clave1=valor1, clave2=valor2)

Técnicas avanzadas para añadir elementos a diccionarios en Python

Comprender los conceptos básicos de la manipulación de diccionarios es esencial, pero para dominar realmente los diccionarios en Python, es importante explorar algunas técnicas avanzadas. Estos métodos mejorarán tu capacidad para gestionar y manipular diccionarios de forma eficaz en situaciones más complejas.

Añadir elementos a listas dentro de un diccionario

A menudo, los diccionarios se utilizan para almacenar listas como valores. Añadir elementos a estas listas requiere un enfoque ligeramente diferente. A continuación te explicamos cómo puedes hacerlo utilizando .append():

# Initialize a dictionary with a list as a value
dictionary_w_list = {'fruits': ['apple', 'banana']}

# Append an element to the list within the dictionary
dictionary_w_list['fruits'].append('cherry')

# Print the updated dictionary
print(dictionary_w_list)
# Output: {'fruits': ['apple', 'banana', 'cherry']}

En este ejemplo, comenzamos con dictionary_w_list, donde la clave 'fruits' se asigna a una lista ['apple', 'banana']. Al utilizar el método .append(), añadimos 'cherry' a la lista. Esta técnica resulta especialmente útil cuando se gestionan colecciones de elementos dentro de un único diccionario.

Combinar diccionarios con el operador de fusión

Python 3.9 introdujo el operador de fusión (|) para combinar diccionarios. Este operador te permite fusionar dos diccionarios en uno nuevo sin esfuerzo:

# Initialize two dictionaries
first_dictionary = {'name': 'Alice', 'age': 25}
second_dictionary = {'city': 'New York', 'email': 'alice@example.com'}

# Merge the dictionaries using the merge operator
merged_dictionary = first_dictionary | second_dictionary

# Print the merged dictionary
print(merged_dictionary)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

En este ejemplo, first_dictionary y second_dictionary se fusionan en un nuevo diccionario merged_dictionary. El operador de fusión (|) combina los pares clave-valor de ambos diccionarios, lo que lo convierte en un método rápido y cómodo para fusionar diccionarios.

Uso del operador de actualización

Para las actualizaciones in situ, Python 3.9 también introdujo el operador de actualización |=. Este operador te permite actualizar el diccionario original con los pares clave-valor de otro diccionario.

# Initialize two dictionaries
first_dictionary = {'name': 'Alice', 'age': 25}
second_dictionary = {'city': 'New York', 'email': 'alice@example.com'}

# Update dict1 in-place using the update |= operator
first_dictionary |= second_dictionary

# Print the updated dictionary
print(first_dictionary)
# Output: {'name': 'Alice', 'age': 25, 'city': 'New York', 'email': 'alice@example.com'}

Aquí, el operadorde actualización |= actualiza first_dictionary con el contenido de second_dictionary en su lugar. Esto significa que se modifica directamente first_dictionary. Este método resulta especialmente útil cuando necesitas actualizar un diccionario existente sin crear uno nuevo.

Conclusión

En este artículo, hemos aprendido sobre los diccionarios de Python y los métodos para añadir pares clave-valor. Comenzamos con técnicas fundamentales como el uso de la notación entre corchetes y el método .update(), que es esencial para realizar actualizaciones rápidas y sencillas. A continuación, pasamos a técnicas más avanzadas, como añadir elementos a listas dentro de diccionarios, fusionar diccionarios con el operador merge (|) y realizar actualizaciones in situ con el operador update |=. Estos métodos proporcionan herramientas potentes para gestionar estructuras de datos complejas y realizar operaciones eficientes.

Hay algunos de nuestros recursos que puedes consultar para ampliar tus conocimientos sobre Python. Puedes echar un vistazo al curso Introducción a Python, que es un excelente punto de partida, ya que proporciona una base sólida sobre los fundamentos de Python, con especial atención a las aplicaciones de la ciencia de datos. El programa de habilidades de programación en Python también ofrece un plan de estudios completo que te llevará de principiante a programador experto.

Nuestro programa de carrera como programador Python también está diseñado para aquellos que desean adentrarse en la programación Python. Ofrece una amplia cobertura de construcciones y técnicas de programación más complejas.


Samuel Shaibu's photo
Author
Samuel Shaibu
LinkedIn

Escritora y profesional de los datos con experiencia a la que le apasiona capacitar a los aspirantes a expertos en el espacio de los datos.

Preguntas frecuentes

¿Cómo añado un nuevo par clave-valor a un diccionario Python?

Puedes añadir un nuevo par clave-valor a un diccionario Python utilizando la notación de corchetes, como dictionary[key] = value. Este método actualiza el diccionario en el lugar donde se encuentra.

¿Qué es el método .update() en los diccionarios Python y cómo se utiliza?

El método ` .update() ` se utiliza para añadir múltiples pares clave-valor a un diccionario. Puede aceptar otro diccionario o un iterable de pares clave-valor, actualizando el diccionario existente.

¿Cuál es la diferencia entre el método .update() y el operador de fusión (|) para combinar diccionarios en Python?

El método ` .update() ` modifica el diccionario existente en el mismo lugar añadiendo pares clave-valor de otro diccionario, lo que puede sobrescribir las claves existentes. El operador merge crea un nuevo diccionario que contiene elementos de ambos diccionarios, dejando los diccionarios originales sin cambios.

Temas

Aprende Python con DataCamp

Curso

Introducción a Python

4 h
6.6M
Domina los fundamentos del análisis de datos con Python en cuatro horas y descubre sus paquetes más usados.
Ver detallesRight Arrow
Comienza el curso
Ver másRight Arrow
Relacionado

Tutorial

Tutorial de comprensión del diccionario Python

¡Aprende todo sobre la comprensión de diccionarios en Python: cómo puedes utilizarla para crear diccionarios, para sustituir los for loops (anidados) o las funciones lambda por map(), filter() y reduce(), ...!
Sejal Jaiswal's photo

Sejal Jaiswal

Tutorial

Tutorial de los métodos .append() y .extend() de Python

Aprende a utilizar los métodos .append() y .extend() para añadir elementos a una lista.
DataCamp Team's photo

DataCamp Team

Tutorial

Tutorial de Python sobre conjuntos y teoría de conjuntos

Aprende sobre los conjuntos en Python: qué son, cómo crearlos, cuándo usarlos, funciones incorporadas y su relación con las operaciones de la teoría de conjuntos.
DataCamp Team's photo

DataCamp Team

Tutorial

Declaración de caso de cambio en Python: Guía para principiantes

Explora el match-case de Python: una guía sobre su sintaxis, aplicaciones en ciencia de datos, ML, y un análisis comparativo con el switch-case tradicional.
Matt Crabtree's photo

Matt Crabtree

Tutorial

Guía completa de listas vacías en Python

Aprenda las principales operaciones con listas y los casos de uso de las listas vacías en Python.
Adel Nehme's photo

Adel Nehme

Tutorial

Operador Morsa de Python: La expresión de asignación (Tutorial)

El operador de morsa := de Python te permite asignar un valor a una variable dentro de una expresión, combinando asignación y uso en un solo paso.
Stephen Gruppetta's photo

Stephen Gruppetta

Ver másVer más