En este módulo aprenderemos qué necesitamos instalar, cómo funciona Python y cómo comprobar que nuestro equipo está preparado.

En el Módulo 1 aprendiste que programar consiste en escribir instrucciones para que un ordenador las ejecute. Pero el ordenador no entiende español ni inglés; solo entiende instrucciones en un formato muy concreto. Python es un lenguaje de programación: un puente entre tu forma de pensar y la forma en que la máquina puede actuar.

Para que ese puente funcione, necesitas dos cosas: un traductor (el intérprete de Python) y un lugar donde escribir tus instrucciones (un archivo de texto). Preparar el entorno significa instalar ese traductor y aprender a darle órdenes. Una vez hecho, podrás escribir tu primer programa y verlo funcionar.

Un intérprete es un programa que lee tu código fuente, lo traduce a instrucciones que la máquina entiende y las ejecuta paso a paso. Python es un lenguaje interpretado, lo que significa que no necesitas compilar todo el programa antes de ejecutarlo: el intérprete va leyendo y ejecutando línea por línea.

[PYTHON] Esta característica (ser interpretado) no es exclusiva de Python; también la tienen JavaScript, Ruby o PHP. Otros lenguajes como C o Java suelen requerir una compilación previa. La ventaja principal es la inmediatez: puedes probar cambios al instante sin esperar a compilar.

A fecha de referencia (octubre de 2026), la versión estable más reciente es Python 3.15, publicada el 9 de octubre de 2026. Sin embargo, para un curso desde cero, lo importante no es perseguir la última versión, sino usar una versión estable, soportada y con buena compatibilidad en Windows y Linux. Python 3.15 es una elección razonable porque es la última estable y ya incluye mejoras de estabilidad y rendimiento.

Windows no incluye Python de serie. Para instalarlo, el método oficial recomendado por el equipo de CPython es el Python Install Manager (Gestor de instalación de Python).

Pasos:

• Accede a python.org/downloads o abre la aplicación Microsoft Store y busca “Python Install Manager”.
• Descarga e instala el gestor. Si usas el archivo descargado, haz doble clic y selecciona “Install”.
• Tras la instalación, abre una terminal nueva (PowerShell o Símbolo del sistema) y escribe: python
• Si todo ha ido bien, verás el intérprete de Python esperando tus órdenes (el prompt >>>).
• También puedes comprobar la versión instalada con: python --version

[WINDOWS] En Windows, el comando python (y también py) lanza el intérprete. Si tienes varias versiones instaladas, py list muestra cuáles están disponibles y cuál es la actual. No necesitas modificar el PATH manualmente si usas el gestor oficial: él se encarga de que los comandos estén disponibles.

[ERROR HABITUAL] Si al escribir python la terminal responde con un mensaje como “no se reconoce como un comando interno o externo”, significa que el intérprete no está en el PATH o que la instalación no se completó. Solución: reinstala usando el gestor oficial y asegúrate de abrir una terminal nueva después. Si el problema persiste, revisa la sección de solución de problemas de la documentación oficial.

En la mayoría de distribuciones Linux, Python 3 ya viene preinstalado. Puedes comprobarlo abriendo una terminal (normalmente con Ctrl + Alt + T) y escribiendo:

python3 --version

Si no está instalado, o si quieres asegurarte de tener la versión más reciente disponible en los repositorios de tu distribución, usa el gestor de paquetes correspondiente:

Debian/Ubuntu y derivados:

sudo apt update
sudo apt install python3

Fedora, CentOS, RHEL y derivados:

sudo dnf install python3

Arch Linux y derivados:

sudo pacman -S python

[WINDOWS / LINUX] En Linux, el comando habitual es python3 (no python), porque python puede hacer referencia a Python 2 en sistemas antiguos. En Windows, el comando es python. Esta diferencia es una fuente constante de confusión para principiantes; memorízala desde el principio.

[ERROR HABITUAL] En Linux, si python3 --version funciona pero python --version no, no es un error: simplemente el alias python no está definido. Usa siempre python3 en Linux para evitar ambigüedades.

Un editor de código es un programa diseñado para escribir texto plano con comodidades para programadores: resaltado de sintaxis, numeración de líneas, etc. Un IDE (Entorno de Desarrollo Integrado) es un programa más completo que incluye editor, terminal integrada, depurador y herramientas de prueba.

Para empezar, cualquiera de estas opciones es válida:

- Visual Studio Code (VS Code): editor gratuito, ligero y multiplataforma. Con la extensión oficial de Python se convierte en un entorno muy potente. Es la recomendación habitual para principiantes porque no abruma y funciona igual en Windows y Linux. - PyCharm (Community Edition): IDE específico para Python, gratuito en su versión comunitaria. Más pesado, pero muy completo. - Editores ligeros: Notepad++ (Windows), Gedit o Kate (Linux). Sirven para empezar, pero carecen de ayudas avanzadas.

[BUENA PRÁCTICA] Elige un editor y úsalo de forma consistente durante las primeras semanas. Cambiar constantemente de herramienta impide interiorizar los atajos y el flujo de trabajo. VS Code es una elección segura para ambos sistemas operativos.

Un programa Python se escribe en un archivo de texto con extensión .py. Vamos a crear el más sencillo posible.

Paso 1: Crear la carpeta de trabajo.

Abre tu terminal y crea una carpeta para el curso:

Windows (PowerShell):

mkdir curso-python
cd curso-python

Linux:

mkdir curso-python
cd curso-python

Paso 2: Crear el archivo.

Abre tu editor de código y crea un archivo nuevo. Escribe exactamente esta línea:

print("Hola, mundo")

Guárdalo dentro de la carpeta curso-python con el nombre hola.py.

Paso 3: Ejecutarlo desde la terminal.

Asegúrate de que estás dentro de la carpeta curso-python y ejecuta:

Windows:

python hola.py

Linux:

python3 hola.py

Deberías ver en la terminal:

Hola, mundo

¿Qué ha ocurrido paso a paso?

• La terminal ha recibido la orden python (o python3) y ha lanzado el intérprete.
• El intérprete ha abierto el archivo hola.py, lo ha leído línea por línea.
• Al encontrar print("Hola, mundo"), ha ejecutado la instrucción: mostrar el texto entre paréntesis en la pantalla.
• Como no había más instrucciones, el programa ha terminado.

[PYTHON] print() es una función incorporada (built-in). No necesitas importarla ni definirla: Python la trae de serie. Su nombre viene del inglés print (“imprimir”), pero en programación significa “mostrar en la salida estándar” (normalmente la pantalla). No es exclusiva de Python; casi todos los lenguajes tienen un mecanismo equivalente (console.log en JavaScript, System.out.println en Java, printf en C).

# archivo: comprobar.py
import sys
 
print("Versión de Python:")
print(sys.version)

- import sys carga el módulo sys, que contiene información sobre el intérprete. - sys.version es una cadena de texto con la versión y la fecha de compilación del intérprete. - print() muestra esa información en pantalla.

Predicción: Antes de ejecutarlo, ¿qué crees que mostrará? Después de ejecutarlo, compara el resultado con tu predicción.

# archivo: saludo.py
print("Bienvenido al curso de Python")
print("Este es mi segundo programa")

Predicción: ¿En qué orden aparecerán las dos líneas en la terminal? ¿Qué pasaría si intercambiaras el orden de las instrucciones?

Cuando ejecutas python hola.py, el intérprete no “adivina” lo que quieres hacer: sigue un proceso mecánico y determinista.

1. Localización del archivo: el intérprete busca hola.py en el directorio actual. 2. Lectura y análisis: lee el archivo y comprueba que la sintaxis es válida. 3. Ejecución secuencial: ejecuta las instrucciones de arriba abajo, una por una. 4. Finalización: cuando no quedan instrucciones, el proceso termina y la terminal vuelve a mostrar el prompt.

Si en algún paso algo falla (por ejemplo, el archivo no existe o hay un error de sintaxis), el intérprete se detiene y muestra un mensaje de error. Aprender a leer esos mensajes es una habilidad fundamental que desarrollarás en el Módulo 3.

[ERROR HABITUAL] Un error muy frecuente en Windows es escribir python cuando se ha instalado solo el launcher y no se ha añadido al PATH. Si py funciona pero python no, puedes usar py hola.py como alternativa inmediata.

Indentación significativa: en Python, los espacios al principio de una línea no son solo estética: indican qué instrucciones pertenecen a un bloque (por ejemplo, dentro de un if o una función). En C, Java o JavaScript se usan llaves {}. Esta es una de las diferencias más visibles para quien viene de otros lenguajes.

Tipado dinámico: no necesitas declarar el tipo de una variable antes de usarla. Python lo deduce en tiempo de ejecución. En Java o C, por ejemplo, debes escribir int edad = 25;; en Python basta con edad = 25. Esto hace el código más corto, pero requiere disciplina para no perder claridad.

Ejecución interpretada: como se ha mencionado, no hay un paso de compilación separado. Esto acelera el ciclo de prueba y error, pero puede hacer que algunos errores solo se detecten al ejecutar esa parte concreta del código.

Incorrecto (poco recomendable):

print("Hola")
print("Adiós")
# El código funciona, pero no hay espacio entre instrucciones y el archivo se llama "untitled1.py"

Mejor:

# archivo: saludo_despedida.py
# Programa que muestra un saludo y una despedida.
 
print("Hola")
print("Adiós")

[BUENA PRÁCTICA] Usa nombres de archivo descriptivos en minúsculas y con guiones bajos (saludo_despedida.py). Añade un comentario breve al principio explicando qué hace el programa. Deja una línea en blanco entre bloques lógicos de instrucciones. Estas pequeñas decisiones facilitan la lectura y el mantenimiento desde el primer día.

[WINDOWS / LINUX] Los comandos mkdir y cd son prácticamente idénticos en ambos sistemas. La diferencia principal al empezar está en el nombre del intérprete (python vs. python3) y en cómo se instala Python. El resto de la experiencia de programación es prácticamente la misma, lo cual es una de las grandes ventajas de Python para la portabilidad.

- Python es un lenguaje interpretado: un programa llamado intérprete lee y ejecuta tu código. - En Windows, se instala con el Python Install Manager y se ejecuta con python o py. - En Linux, suele venir preinstalado y se ejecuta con python3; si falta, se instala con el gestor de paquetes de la distribución. - Un editor de código (como VS Code) es donde escribes; la terminal es donde das la orden de ejecutar. - Un programa Python se guarda en un archivo .py y se ejecuta con python archivo.py (Windows) o python3 archivo.py (Linux). - Los errores de PATH, de nombre de archivo y de sintaxis son los primeros obstáculos; leer el mensaje de error es el primer paso para resolverlos.

Un proyecto es simplemente una carpeta que agrupa todo lo relacionado con un mismo trabajo: tus programas, los datos que utilizan y, más adelante, las pruebas y la documentación. No necesitas una herramienta especial para crearlo; basta con una carpeta y una estructura mínima.

Durante este curso, al principio trabajarás con archivos .py sueltos dentro de una misma carpeta. Una organización razonable para los primeros módulos es esta:

curso-python/
├── main.py
├── ejercicios/
│   ├── ejercicio_01.py
│   └── ejercicio_02.py
└── pruebas/
    └── prueba_rapida.py

- main.py es el archivo principal desde el que ejecutas el programa. - ejercicios/ es una subcarpeta donde guardas los ejercicios del curso. - pruebas/ es una subcarpeta para programas de prueba que no forman parte del proyecto principal.

[BUENA PRÁCTICA] Nombra los archivos con minúsculas, sin espacios ni tildes, usando guiones bajos si necesitas separar palabras: calculadora_basica.py es mejor que Calculadora Básica.py. Los espacios en los nombres obligan a escribir comillas o a escapar caracteres en la terminal, y las tildes pueden dar problemas en algunos entornos. Esta convención es habitual en proyectos reales y evita fallos innecesarios.

[AMPLIACIÓN] Más adelante, en el Módulo 12, verás que cuando un proyecto crece se organiza en paquetes (carpetas con un archivo especial llamado __init__.py). Por ahora no lo necesitas: basta con archivos .py en la misma carpeta o en subcarpetas simples. No introduzcas complejidad que todavía no puedas aprovechar.

Si estás en la carpeta curso-python/ y quieres ejecutar ejercicios/ejercicio_01.py, debes indicar la ruta:

- Windows: python ejercicios\ejercicio_01.py (o py ejercicios\ejercicio_01.py). - Linux: python3 ejercicios/ejercicio_01.py.

[WINDOWS / LINUX] Windows usa la barra invertida \ como separador de rutas; Linux usa la barra normal /. Python acepta ambas en muchos contextos, pero la terminal de Windows espera \ y la de Linux espera /. Si escribes la barra equivocada, el intérprete no encontrará el archivo.

La terminal es una herramienta, no un obstáculo. Con cinco comandos puedes hacer el 90% de lo que necesitas al empezar.

[WINDOWS] PowerShell acepta alias como ls, cd y mkdir, pero los flags (las opciones que empiezan por -) no son idénticos a los de Linux. Por ejemplo, ls -l en Linux muestra una lista detallada; en PowerShell, ls -l no funciona igual. Para empezar, quédate con ls y cd, que funcionan en ambos sistemas sin sorpresas.

Objetivo: crear una subcarpeta ejercicios dentro de curso-python y entrar en ella.

Linux:

cd curso-python
mkdir ejercicios
cd ejercicios
pwd

Windows (PowerShell):

cd curso-python
mkdir ejercicios
cd ejercicios
pwd

Qué ocurre paso a paso:

1. cd curso-python cambia el directorio de trabajo a la carpeta del curso. Si la carpeta no existe en la ubicación actual, la terminal mostrará un error. 2. mkdir ejercicios crea una carpeta vacía llamada ejercicios. 3. cd ejercicios entra en esa carpeta. 4. pwd confirma que ahora estás dentro de curso-python/ejercicios.

[ERROR HABITUAL] Si cd curso-python falla con “No such file or directory”, significa que no estás en la carpeta que contiene curso-python. Usa ls (Linux) o ls/dir (Windows) para ver qué hay en tu ubicación actual, y retrocede con cd .. si es necesario.

[BUENA PRÁCTICA] Usa pwd con frecuencia. Saber exactamente dónde estás evita la mayoría de los errores del tipo “archivo no encontrado”. La terminal no adivina: ejecuta el archivo que le indicas relativo a la carpeta en la que estás.

Los errores de instalación son la primera pared con la que choca todo principiante. Casi nunca son culpa tuya: son consecuencia de cómo Windows y Linux gestionan los comandos y las rutas. Aquí tienes los más habituales, ordenados por sistema operativo.

Síntoma: escribes python en la terminal y, en lugar de abrir el intérprete, se abre la Microsoft Store en la página de Python.

Causa: Windows incluye un archivo python.exe “falso” en el PATH que redirige a la Store. Es un alias de ejecución de aplicaciones (App Execution Alias), no una instalación real de Python.

Soluciones:

1. La más rápida: usa el comando py en lugar de python. El lanzador de Python para Windows (py launcher) no se ve afectado por el alias falso y localiza la instalación real.

  ```powershell
  py --version
  py main.py
  ```

2. La definitiva: desactiva el alias. Ve a Configuración → Aplicaciones → Aplicaciones avanzadas → Alias de ejecución de aplicaciones y desactiva python.exe y python3.exe. Después de esto, python funcionará correctamente si el intérprete real está en el PATH.

[WINDOWS] El comando py es específico de Windows y es la forma más fiable de lanzar Python cuando hay varias versiones instaladas o cuando el PATH no está configurado manualmente. py list muestra todas las versiones disponibles y cuál es la actual.

Síntoma: “python no se reconoce como un comando interno o externo” o “py no se reconoce…”.

Causa: el intérprete o el lanzador no están en el PATH, o la instalación no se completó correctamente.

Soluciones:

- Si py sí funciona pero python no: usa py y no te preocupes. Es una situación normal y perfectamente válida. - Si ninguno de los dos funciona: reinstala Python usando el Python Install Manager oficial desde python.org/downloads. Durante la instalación, el gestor ofrece la opción de añadir Python al PATH; acéptala si prefieres usar python en lugar de py. - Abre siempre una terminal nueva después de instalar. Las terminales abiertas antes de la instalación no ven los cambios en el PATH.

[ERROR HABITUAL] No intentes arreglar el PATH a mano copiando rutas de internet sin entender qué estás añadiendo. Una entrada incorrecta en el PATH puede romper otros comandos. Si necesitas modificarlo, hazlo con el instalador oficial o sigue la sección de solución de problemas de la documentación de Python para Windows.

Síntoma: la terminal no reconoce python3.

Causa: Python 3 no está instalado, o no está en el PATH.

Solución: instálalo con el gestor de paquetes de tu distribución:

- Debian/Ubuntu:

  ```bash
  sudo apt update
  sudo apt install python3
  ```

- Fedora:

  ```bash
  sudo dnf install python3
  ```

- Arch Linux:

  ```bash
  sudo pacman -S python
  ```

Después de instalar, comprueba con python3 --version.

No es un error. En la mayoría de las distribuciones modernas, el comando python no existe a propósito para evitar confusiones con Python 2, que está obsoleto. Usa siempre python3 en Linux. Si por alguna razón necesitas que python funcione, puedes crear un alias en tu archivo de configuración del shell (.bashrc o .zshrc), pero no es necesario y no lo recomendamos para este curso.

Causa: estás intentando ejecutar el archivo directamente (./script.py) sin permiso de ejecución.

Solución: no necesitas dar permisos de ejecución. Ejecuta siempre el script a través del intérprete:

python3 script.py

[BUENA PRÁCTICA] No uses sudo para ejecutar tus propios scripts de Python. sudo es para tareas de administración del sistema, no para programas de usuario. Ejecutar tus scripts con sudo puede crear archivos con permisos incorrectos y dificultar su gestión posterior.

• Un proyecto es una carpeta con tus archivos .py organizados en subcarpetas con nombres descriptivos y sin espacios.
• Con pwd, ls, cd y mkdir puedes navegar y organizar tu espacio de trabajo en cualquier sistema operativo.
• En Windows, el comando py es más fiable que python cuando hay alias de la Store o varias versiones instaladas.
• En Linux, usa siempre python3; el comando python no existe por defecto en las distribuciones modernas.
• Los errores de “comando no encontrado” o “archivo no encontrado” casi siempre se reducen a un problema de ruta o de PATH, no a un fallo de Python.