Instalar Python y ejecutar tu primer programa

El problema que vamos a resolver

Quieres aprender Python. Hay muchos sitios donde puedes escribir código en el navegador, pero en el trabajo nadie escribe código en un navegador. En el trabajo, Python está instalado en tu propia máquina, escribes código en un editor, abres una terminal y ejecutas comandos, y guardas archivos y los ejecutas.

Así que trabajaremos de esa manera desde el primer día. Al terminar este capítulo tendrás Python real en tu ordenador, un editor para escribir código y habrás ejecutado un programa con él.

Al terminar este capítulo podrás

• Instalar el último Python (3.12 o más nuevo) en Windows, macOS o Linux
• Comprobar desde la terminal que la instalación realmente funciona
• Instalar VS Code, escribir un archivo .py en él y ejecutar el archivo
• Reconocer y corregir los errores de instalación más comunes

Requisitos previos: ninguno. Este es el primer capítulo.

Paso 1 — Instalar Python

Instala el último Python 3 —cualquier versión desde 3.12 en adelante sirve. Los ejemplos de este curso se ejecutaron en Python 3.12 y funcionan igual en versiones más nuevas. Lee la parte para tu sistema operativo; puedes saltarte las otras dos.

Windows

Ve a python.org/downloads. El gran botón amarillo en la parte superior de la página te da el instalador de la última versión de Python 3. Descárgalo.

No instales desde la Microsoft Store. En Windows, escribir python a menudo abre la Store. La versión de la Store se ejecuta en un entorno restringido, lo que causa fallos extraños más tarde cuando instalas paquetes o escribes archivos junto a tu código. Usa python.org.

Cuando se abra el instalador, hay una casilla pequeña en la parte inferior de la primera pantalla:

[ ] Add python.exe to PATH

Márcala. En Windows este es el paso más importante del capítulo.

PATH es la lista que Windows busca para decidir qué programas pueden ejecutarse desde cualquier sitio. Sin ella Python se instala, pero escribir python en una terminal te da un error, porque Windows no sabe dónde está Python.

Luego pulsa Install Now.

macOS

Ve a python.org/downloads. El gran botón amarillo te da el instalador .pkg del último Python 3 para macOS. Abre el archivo y pulsa Continue e Install hasta que termine. Si pide contraseña, introduce la contraseña de acceso a tu Mac.

En macOS el comando se llama python3, no python. Donde este curso muestra python, escribe python3 en un Mac.

Linux

La mayoría de distribuciones Linux (Ubuntu, Debian, Fedora) ya vienen con Python 3. Compruébalo en el Paso 2 de abajo. Si falta, instálalo con el gestor de paquetes —en Ubuntu o Debian:

sudo apt install python3

En Fedora:

sudo dnf install python3

Si tu versión es anterior a 3.12, una versión más nueva de tu distribución (por ejemplo Ubuntu 24.04 o posterior) tiene 3.12 o más nuevo.

En Linux el comando también se llama python3. Donde este curso muestra python, escribe python3 en Linux.

Paso 2 — Verificar

Cuando la instalación termine, abre una terminal nueva:

• Windows: pulsa Inicio, escribe powershell y abre PowerShell
• macOS: pulsa Cmd + Espacio, escribe Terminal y abre Terminal
• Linux: abre Terminal desde el menú de aplicaciones (Ctrl + Alt + T en Ubuntu)

Abrir una terminal nueva es importante. Cualquier terminal que ya estuviera en marcha sigue recordando el PATH antiguo y no verá la nueva instalación.

En Windows, escribe este comando y pulsa Enter:

python --version

En macOS o Linux, escribe:

python3 --version

Deberías ver algo como:

Python 3.12.3

Tu número puede ser diferente, por ejemplo empezando por 3.13 o 3.14 —eso está bien. Mientras las dos primeras partes sean 3.12 o superiores, estás listo.

Paso 3 — Instalar VS Code

Necesitas un editor de código para escribir código. Editores simples como Notepad o TextEdit pueden añadir .txt al final de un nombre de archivo sin avisar, y no colorean tu código ni muestran errores. Usaremos VS Code: es gratis, funciona en los tres sistemas operativos y es uno de los editores más usados en el trabajo.

1. Ve a code.visualstudio.com, pulsa el botón de descarga para tu sistema operativo y ejecuta el instalador
2. Abre VS Code. Pulsa el icono Extensiones a la izquierda (o pulsa Ctrl + Shift + X en Windows y Linux, Cmd + Shift + X en macOS)
3. Escribe Python en la caja de búsqueda e instala la extensión Python hecha por Microsoft

Python funciona sin la extensión, pero con ella VS Code colorea tu código y señala errores mientras escribes.

Paso 4 — Tu primer programa

1. Crea una carpeta llamada python-lab en tu carpeta personal. En Windows la carpeta personal es C:\Users\<nombre>, en macOS /Users/<nombre> y en Linux /home/<nombre> —<nombre> representa tu nombre de usuario
2. En VS Code, abre la carpeta python-lab con File → Open Folder
3. Pulsa File → New File, nómbralo hello.py y escribe esto dentro:

language = "Python"
print("Hello from", language)
print("2 + 3 =", 2 + 3)

Guarda el archivo (Ctrl + S en Windows y Linux, Cmd + S en macOS). Luego abre una terminal dentro de VS Code: Terminal → New Terminal. Esta terminal se abre en la carpeta python-lab por sí sola.

Ahora ejecuta el archivo. En Windows:

python hello.py

En macOS o Linux:

python3 hello.py

Salida:

Hello from Python
2 + 3 = 5

Tu ordenador acaba de ejecutar un programa Python. No un navegador, no un sitio web —tu propia máquina.

Cuando algo falla

Escribir python abre la Microsoft Store (Windows) Python no está en PATH, así que Windows ejecuta su propio acceso directo en su lugar. Ejecuta el instalador otra vez, elige Modify y marca "Add python.exe to PATH". Luego abre una terminal nueva.

python : The term 'python' is not recognized... (Windows) Misma causa, misma solución. También puedes comprobar si py --version funciona —py es el lanzador de Python de Windows y funciona incluso sin PATH.

command not found: python (macOS o Linux) En macOS y Linux el comando se llama python3. Escribe python3 --version y python3 hello.py. Si python3 tampoco se encuentra, Python no está instalado —vuelve al Paso 1.

python hello.py dice can't open file La terminal está en la carpeta equivocada. Escribe ls y comprueba que hello.py está en la lista (ls funciona en Windows PowerShell también). Si no está, cd a la carpeta correcta, o abre una terminal nueva en VS Code con Terminal → New Terminal.

El archivo se llama en realidad hello.py.txt Esto pasa cuando guardas desde Notepad o TextEdit, y como Windows oculta las extensiones de archivo por defecto, no lo ves. Crea el archivo en VS Code. Para ver las extensiones en Windows, activa View → Show → File name extensions en el Explorador de archivos y luego renombra el archivo.

Tu turno

Cambia hello.py para que imprima tu propio nombre y muestre el resultado de 7 * 6. Guárdalo y ejecútalo otra vez —python hello.py en Windows, python3 hello.py en macOS o Linux.

La salida debería ser algo como:

Hello from <your name>
7 * 6 = 42