Ayuda con Python: No entiendo por qué mi variable cambia "sola" dentro de una función

DIYer

Estoy empezando y me he topado con un comportamiento que no entiendo. Tengo una lista y se la paso a una función para que le añada un elemento. El problema es que la lista original, fuera de la función, también cambia. ¿No se supone que las variables dentro de una función son locales?

def add_item(my_list):
    my_list.append(4)
    print("Dentro de la función:", my_list)

numbers = [1, 2, 3]
print("Antes de llamar:", numbers)
add_item(numbers)
print("Después de llamar:", numbers) # ¿Por qué aquí sale [1, 2, 3, 4]?

Esperaba que el resultado final fuera [1, 2, 3]. ¿Qué está pasando?

Anime

Es porque en Python los argumentos se pasan por referencia. Cuando pasas la lista a la función, no estás pasando una copia, sino una referencia a la lista original. Por eso se modifica.

Retro

Cuidado, compañero, esa es una imprecisión muy común. Python no usa "paso por referencia" como C++. El sistema se llama "paso por asignación" o "paso por referencia de objeto".

La variable my_list dentro de la función apunta al MISMO objeto lista en memoria que la variable numbers de fuera. Por eso, cuando usas un método que muta el objeto (como .append()), el cambio se ve en todas las variables que apuntan a él.

Anime

Ah, tienes toda la razón. "Paso por asignación" es el término correcto. Gracias por la corrección. Lo importante es el concepto de que se modifica el objeto original.

DIYer

Vale, creo que lo entiendo. Así que si no quiero que la lista original cambie, ¿tendría que pasarle una copia a la función?

Retro

¡Exacto! Esa es la solución. Puedes hacerlo de varias formas. La más sencilla es llamar a la función así:

add_item(numbers.copy())
# O también
add_item(numbers[:])

Ambas formas crean una copia superficial (shallow copy) de la lista antes de pasarla, por lo que la función modificará la copia y la original quedará intacta.

Minimalism

Esto solo pasa con objetos mutables como listas y diccionarios, ¿verdad? Si le pasara un número o un string, no pasaría.

Retro

Correcto. Los números, strings, tuplas, etc., son inmutables. No puedes cambiar su valor "por dentro". Si dentro de una función haces mi_numero = mi_numero + 1, en realidad estás creando un nuevo objeto número y haciendo que la variable local apunte a él. La variable original de fuera no se entera.

Este concepto de mutabilidad vs. inmutabilidad es una de las cosas más importantes que hay que entender bien en Python.

Indie

Qué buen hilo. Me acaba de aclarar una duda que llevaba arrastrando meses. La explicación de "paso por asignación" y la diferencia entre objetos mutables e inmutables es oro puro. ¡Gracias a todos!

Anime

Me alegro de que mi error inicial haya servido para generar una explicación tan buena. Yo también he repasado el concepto. ¡Así da gusto!

DIYer

De verdad, mil gracias. Ahora todo tiene sentido. He probado a pasarle una copia a la función y funciona exactamente como esperaba. ¡Esta comunidad es increíble!