¿Qué es if __name__ == «__main__» en Python y por qué se usa? Explicación fácil y ejemplos

¿Qué significa if __name__ == "__main__" en Python?

Si alguna vez has leído o escrito un script en Python, probablemente hayas visto la línea if __name__ == "__main__":.
Esta construcción es muy común y, aunque parece misteriosa al principio, su función es esencial para controlar cómo y cuándo se ejecuta un bloque de código.

¿Para qué sirve if __name__ == "__main__"?

En términos simples, esta línea permite que cierto código solo se ejecute cuando el archivo es ejecutado directamente,
y no cuando es importado como un módulo en otro archivo Python.

Esto es especialmente útil para separar el código que define funciones y clases del código que las ejecuta.

¿Cómo funciona if __name__ == "__main__"?

Entendiendo __name__

En Python, cada archivo (o módulo) tiene una variable especial llamada __name__.
Cuando ejecutas un archivo directamente, __name__ toma el valor «__main__».
Si el archivo es importado desde otro, __name__ toma el nombre del archivo o módulo.

Ejemplo básico

# archivo ejemplo.py

def saludar():
    print("¡Hola, mundo!")

if __name__ == "__main__":
    saludar()
    

Si ejecutas este archivo directamente (python ejemplo.py), verás ¡Hola, mundo! en la consola.
Pero si lo importas desde otro archivo, la función saludar() no se ejecutará automáticamente.

¿Por qué se usa if __name__ == "__main__" en Python?

• Evita la ejecución accidental: Si importas el archivo en otro script, el código dentro del if no se ejecutará.
• Permite reutilizar código: Puedes definir funciones y clases que otros archivos puedan importar sin ejecutar la lógica principal.
• Facilita las pruebas: Puedes escribir pruebas o ejemplos de uso que solo se ejecuten cuando el archivo sea el principal.

Explicación fácil: ¿Qué hace exactamente if __name__ == "__main__":?

Imagina que tienes un archivo llamado calculadora.py:

# calculadora.py

def sumar(a, b):
    return a + b

if __name__ == "__main__":
    print(sumar(3, 4))
    

Si ejecutas python calculadora.py, la salida será 7.
Pero si desde otro archivo haces:

import calculadora

resultado = calculadora.sumar(10, 5)
print(resultado)
    

El código dentro del if __name__ == "__main__": no se ejecutará,
solo se ejecutará el código que tú llames explícitamente.

Variaciones y otras formas de verlo

¿Por qué usar if __name__ == "__main__": en proyectos grandes?

En proyectos con varios archivos, es imprescindible utilizar esta estructura para que
el código de prueba o de ejemplo no se ejecute al importar módulos.
Así, cada archivo puede tener su propia lógica de pruebas o ejecución independiente.

¿Qué ocurre si no se utiliza if __name__ == "__main__":?

Si no usas esta condición, todo el código del archivo se ejecutará incluso si solo quieres importar una función.
Esto puede provocar resultados no deseados o errores.

Resumen y consejos finales

• Usa siempre if __name__ == "__main__": para separar la ejecución principal de la definición de funciones y clases.
• Facilita la reutilización y el mantenimiento de tu código aplicando esta buena práctica en tus scripts.
• Recuerda: Es fundamental para que tus módulos sean importables sin efectos secundarios no deseados.

Ejemplo completo: Paso a paso

Paso 1: Crea un archivo mensaje.py

# mensaje.py

def mostrar_mensaje():
    print("¡Este es un mensaje importante!")

if __name__ == "__main__":
    mostrar_mensaje()
    

Paso 2: Crea un segundo archivo usar_mensaje.py

# usar_mensaje.py

import mensaje

print("He importado el módulo mensaje.")
    

Paso 3: Ejecuta ambos archivos

• Al ejecutar mensaje.py directamente: python mensaje.py se mostrará ¡Este es un mensaje importante!
• Al ejecutar usar_mensaje.py: python usar_mensaje.py NO mostrará el mensaje, solo He importado el módulo mensaje.

Como ves, usar if __name__ == "__main__": es una práctica fundamental en Python para controlar la ejecución de tus scripts
y hacer que tu código sea más ordenado, reutilizable y profesional.