Terminábamos la lección anterior con la elección hecha: Python. Ahora toca lo más terrenal del módulo, y probablemente lo que más frustración causa a quien empieza. Antes de escribir código hay que montar el puesto de trabajo: instalar el intérprete, tener un editor decente, saber usar la terminal y organizar los ficheros de forma que dentro de tres semanas sigas encontrándolos.

Esta parte se suele despachar con un «instala Python y ya está», y luego la gente se atasca durante horas con un python: command not found que nadie le ha explicado. Aquí no vamos a hacer eso: veremos qué piezas forman un entorno de desarrollo, cómo instalarlas en los tres sistemas operativos, cómo comprobar que funcionan y qué hacer cuando no funcionan.

Al final de la lección tendrás un entorno operativo y habrás creado y ejecutado tareafacil.py, el fichero que iremos ampliando hasta el final del curso.

1. Qué es un entorno de desarrollo y qué piezas lo forman
2. La terminal: la herramienta que nadie te presenta
3. Instalar Python 3 en Windows, macOS y Linux
4. Comprobar la instalación
5. El intérprete interactivo (REPL)
6. Ejecutar un fichero .py
7. Editor de texto frente a IDE
8. Configuración mínima de VS Code para Python
9. Estructura de carpetas de un proyecto pequeño
10. Entornos virtuales con venv
11. Crear y ejecutar tareafacil.py
12. Errores comunes y consejos
13. Ejercicios
14. Conclusión

Un entorno de desarrollo es el conjunto de herramientas con las que escribes, ejecutas y corriges programas. No es un producto que se instale de una vez: son varias piezas que colaboran.

Las cuatro primeras son imprescindibles desde hoy. Los entornos virtuales los veremos aquí porque conviene tomar la costumbre pronto. Git lo mencionamos y lo dejamos para Control de versiones: es importante, pero añadirlo ahora sería sobrecargar la primera semana.

La terminal (también «consola» o «línea de comandos») es una ventana donde escribes órdenes en texto y el sistema las ejecuta. Es incómoda al principio porque no hay nada que pulsar, pero es donde se lanza Python, así que no hay forma de evitarla.

Solo necesitas cuatro órdenes para todo el curso:

El concepto clave es el directorio de trabajo: la terminal siempre está «situada» en una carpeta, y las órdenes se ejecutan respecto a esa carpeta. Si escribes python tareafacil.py estando en el sitio equivocado, el sistema te dirá que no encuentra el fichero. No es un error de Python: es que estás en otra carpeta. Este malentendido causa, con diferencia, la mayoría de bloqueos del primer día.

Dos atajos que ahorran mucho tiempo:

• Tabulador autocompleta nombres de fichero y carpeta. Escribe tare y pulsa Tab.
• Flecha arriba recupera la orden anterior. La usarás cientos de veces para reejecutar el programa tras cada cambio.

Necesitamos Python 3.10 o superior. Cualquier versión 3.x reciente sirve para este curso.

Sobre Windows, insiste el aviso porque es el fallo número uno: si no marcas «Add Python to PATH», la terminal no encontrará el comando python y obtendrás un error desconcertante. Si ya has instalado sin marcarla, vuelve a lanzar el instalador, elige Modify y actívala.

Sobre macOS, un detalle: los Mac traen de fábrica un Python del sistema que puede estar desactualizado y que no conviene tocar, porque lo usa el propio sistema operativo. Instala uno propio con Homebrew o con el instalador oficial.

Abre una terminal nueva (importante: las ya abiertas no ven los cambios del PATH) y escribe:

Deberías ver algo como:

Si en su lugar aparece Python 2.7.x, o un error de comando no encontrado, prueba con:

En macOS y Linux es habitual que el comando correcto sea python3, porque python a secas se reservó históricamente para la versión 2. Usa el que te funcione y sé consistente durante todo el curso.

Comprueba también el gestor de paquetes:

Si pip no está disponible, prueba pip3 --version o, en cualquier sistema, la forma más robusta:

Esta última forma —python -m pip— es la más fiable porque usa explícitamente el pip asociado al Python que estás ejecutando, y evita confusiones cuando hay varias versiones instaladas.

Python ofrece dos formas de ejecutar código, y conviene entender bien la diferencia.

La primera es el intérprete interactivo o REPL (Read-Eval-Print Loop: lee, evalúa, imprime, repite). Se abre escribiendo python sin nada más:

Aparece algo así:

Los tres símbolos >>> son el prompt: Python está esperando que escribas algo. Cada línea que escribas se ejecuta al pulsar Enter y su resultado se muestra al momento:

Fíjate en un detalle: al escribir 2 + 3 aparece 5 sin necesidad de print. El REPL muestra automáticamente el valor de lo que escribes. Esto solo pasa aquí; en un fichero .py, si quieres ver algo, tienes que pedirlo con print.

Para salir del REPL:

También funciona Ctrl+D (macOS/Linux) o Ctrl+Z seguido de Enter (Windows).

Para qué sirve realmente el REPL: para probar cosas sueltas. ¿Qué devuelve esta operación? ¿Cómo se escribe exactamente esta instrucción? ¿Esto que creo que vale 5 vale 5? Es un banco de pruebas inmediato, y lo usarás constantemente durante el curso.

Para qué no sirve: para escribir programas. Todo lo que escribes en el REPL desaparece al salir.

La segunda forma —la que usaremos para TareaFácil— es escribir el código en un fichero de texto con extensión .py y pedirle a Python que lo ejecute entero.

Supongamos un fichero llamado tareafacil.py con este contenido:

Desde la terminal, situado en la carpeta donde está el fichero, se ejecuta así:

Y la salida es:

El proceso completo, paso a paso:

Ese bucle —editar, guardar, ejecutar, mirar— es literalmente en lo que consiste programar. Lo repetirás miles de veces. Dos avisos que ahorran disgustos:

• Guardar antes de ejecutar. Python lee el fichero del disco, no lo que ves en pantalla. Si no has guardado, ejecuta la versión anterior y te vuelves loco buscando por qué el cambio no hace efecto.
• Estar en la carpeta correcta. Si obtienes can't open file 'tareafacil.py': No such file or directory, comprueba con ls (o dir) que el fichero está donde estás tú.

Podrías escribir Python en el Bloc de notas, pero sería como escribir a mano una hoja de cálculo. Las herramientas se dividen en dos familias.

Un editor de código es un editor de texto con superpoderes para programar: colorea la sintaxis, autocompleta, señala errores. Un IDE (Integrated Development Environment) añade un conjunto integrado de herramientas: depurador, gestión de proyectos, ejecución de pruebas, refactorización.

La recomendación para este curso es VS Code: es gratuito, funciona igual en los tres sistemas, tiene un soporte de Python excelente y es lo que probablemente encontrarás en un entorno profesional. Si te sientes muy perdido con la instalación, Thonny es una alternativa perfectamente digna para las primeras semanas: trae su propio Python incorporado, así que evita todos los problemas del apartado 3.

Estas son las funciones que de verdad te van a servir, independientemente de la herramienta:

• Coloreado de sintaxis. Textos, números y palabras clave en colores distintos. Cuando un texto entero se colorea mal, casi siempre es una comilla sin cerrar: el editor te está avisando de un error antes de ejecutar.
• Subrayado de errores. Un subrayado ondulado rojo bajo un paréntesis que falta.
• Autocompletado. Escribe pri y ofrece print. Evita erratas.
• Indentación automática. Crítica en Python, donde la indentación forma parte de la sintaxis.
• Ejecución integrada. Un botón de play que lanza el fichero sin ir a la terminal.

Cuatro pasos y no más. La tentación de instalar veinte extensiones el primer día acaba en un editor lento y lleno de avisos que no entiendes.

Paso 1. Instalar VS Code. Desde code.visualstudio.com, instalador estándar para tu sistema.

Paso 2. Instalar la extensión de Python. Abre el panel de extensiones (Ctrl+Shift+X o Cmd+Shift+X), busca Python e instala la publicada por Microsoft. Trae consigo Pylance, que da autocompletado y detección de errores.

Paso 3. Seleccionar el intérprete. Pulsa Ctrl+Shift+P (Cmd+Shift+P en Mac), escribe Python: Select Interpreter y elige tu Python 3. Si más adelante creas un entorno virtual, aquí es donde lo seleccionarás. Este paso es el que la gente se salta y luego no entiende por qué el editor no reconoce nada.

Paso 4. Abrir la carpeta del proyecto, no el fichero suelto. Usa Archivo → Abrir carpeta y abre la carpeta completa de TareaFácil. VS Code trabaja con la noción de proyecto: si abres un fichero aislado, pierdes la mitad de las funciones y la terminal integrada arranca en el sitio equivocado.

Dos ajustes opcionales que se agradecen: activar Auto Save (Archivo → Auto Save), que elimina de raíz el problema de ejecutar sin guardar, y abrir la terminal integrada con Ctrl+ñ (o desde Terminal → Nueva terminal), que arranca ya situada en la carpeta del proyecto.

Un programa de una sola lección cabe en un fichero. TareaFácil, al final del curso, no. Empezar con una estructura mínima ordenada cuesta cinco minutos y ahorra mucho después.

Las reglas que conviene respetar desde el primer día:

• Una carpeta por proyecto. No mezcles TareaFácil con los ejercicios sueltos del curso. Ten, por ejemplo, curso-programacion/tareafacil/ y curso-programacion/ejercicios/.
• Nombres sin espacios, acentos ni eñes. tareafacil.py, no Tarea Fácil.py. Los espacios complican las órdenes de terminal y los acentos dan problemas entre sistemas.
• Nombres en minúsculas y con guion bajo si hay varias palabras: gestor_tareas.py. Es la convención de Python y la seguiremos todo el curso.
• Nunca llames a un fichero como una biblioteca de Python. Si creas random.py o json.py, tu fichero tapará al del sistema y obtendrás errores incomprensibles. Este error aparece cada año en miles de foros.

El fichero README.md es texto plano donde explicas qué hace el programa y cómo se lanza. Parece innecesario cuando eres la única persona que lo usa; deja de parecerlo en cuanto vuelves al proyecto tres meses después. Lo trataremos en serio en Documentación y comentarios.

Este apartado resuelve un problema que aún no tienes, y por eso merece explicación antes que comandos.

El problema. Las bibliotecas de terceros se instalan con pip. Si las instalas «en el Python del sistema», todas tus versiones son compartidas por todos tus proyectos. Imagina que TareaFácil necesita la versión 1.0 de una biblioteca y un proyecto posterior necesita la 2.0, que cambió cosas: al instalar la 2.0, TareaFácil deja de funcionar. Con dos proyectos es molesto; con diez es inmanejable. Además, al pasarle el proyecto a otra persona, no hay forma de saber qué necesita exactamente.

La solución. Un entorno virtual es una copia aislada de Python, con sus propias bibliotecas, que vive dentro de la carpeta del proyecto. Cada proyecto tiene el suyo, y lo que instales en uno no afecta a los demás.

Crear el entorno. Situado en la carpeta del proyecto:

Esto crea una carpeta .venv con la copia aislada. El punto inicial la marca como oculta y es la convención habitual.

Activarlo. Aquí sí hay diferencias por sistema:

Cuando está activo, el prompt de la terminal muestra el nombre entre paréntesis:

Ese (.venv) es la confirmación de que todo lo que instales con pip irá al entorno del proyecto y no al sistema. Para desactivarlo:

Nota para Windows: si PowerShell responde con un error de directivas de ejecución, ejecuta una vez Set-ExecutionPolicy -Scope CurrentUser RemoteSigned y confirma. Es un mecanismo de seguridad de Windows, no un fallo de Python.

Aviso honesto: durante los primeros módulos de este curso no vas a instalar ninguna biblioteca externa, porque Python trae todo lo necesario de fábrica. Así que si ahora mismo te resulta demasiado, puedes seguir sin entorno virtual y volver a este apartado más adelante. Se incluye aquí porque es el sitio donde corresponde y porque conviene coger la costumbre antes de tener el problema.

Momento de juntar todo. Vamos a crear el fichero que nos acompañará hasta el módulo 9.

Paso 1. Crea una carpeta llamada tareafacil en un sitio que recuerdes (Documentos, por ejemplo).

Paso 2. Abre VS Code, Archivo → Abrir carpeta, y selecciona esa carpeta.

Paso 3. Crea un fichero nuevo llamado exactamente tareafacil.py (con la extensión .py; sin ella, el editor no sabrá que es Python y no coloreará nada).

Paso 4. Escribe este contenido:

Las tres primeras líneas empiezan por #: son comentarios. Python los ignora por completo al ejecutar; están ahí para las personas que lean el fichero. Es la primera buena práctica del curso y la mantendremos: todo fichero empieza diciendo qué es y para qué sirve.

Paso 5. Guarda con Ctrl+S (Cmd+S en Mac).

Paso 6. Abre la terminal integrada (Ctrl+ñ) y ejecuta:

Deberías ver exactamente esto:

Si has llegado hasta aquí, tienes un entorno de desarrollo funcionando y el proyecto arrancado. El programa todavía no hace nada útil —solo muestra texto—, pero ya es real: está en tu disco, lo has ejecutado tú y lo iremos ampliando módulo a módulo.

python: command not found en Windows. No se marcó «Add Python to PATH» durante la instalación. Reinstala eligiendo Modify y activa la casilla. Recuerda abrir una terminal nueva después.

El comando es python3 y no python. Muy habitual en macOS y Linux. Comprueba cuál funciona con python3 --version y usa ese durante todo el curso. Mezclarlos causa confusiones difíciles de diagnosticar.

can't open file 'tareafacil.py'. No estás en la carpeta correcta. Ejecuta ls (o dir) para ver los ficheros de donde estás y cd para moverte. Abrir la carpeta en VS Code y usar la terminal integrada evita este problema casi siempre.

Ejecutar sin guardar. Cambias el código, ejecutas y no ves diferencia. Python lee el fichero del disco. Activa Auto Save y olvídate.

Guardar el fichero sin extensión .py. Si el editor lo guarda como tareafacil.py.txt (Windows oculta las extensiones conocidas por defecto), Python no lo reconocerá. Actívalas en el explorador de archivos.

Llamar a un fichero como una biblioteca estándar. random.py, json.py, math.py, test.py. Tu fichero tapa al del sistema y provoca errores absurdos e imposibles de relacionar con la causa. Usa nombres propios del proyecto.

Copiar código de una web con caracteres raros. Algunas páginas sustituyen las comillas rectas " por comillas tipográficas " ". Python no las acepta y da un error de sintaxis desconcertante. Si has copiado algo y falla sin motivo, reescribe las comillas a mano.

Intentar instalar cinco herramientas el primer día. Python, un editor y la terminal. Nada más. Cada pieza extra es una fuente de problemas que no puedes diagnosticar todavía.

Consejo: anota en el README.md el comando exacto que te funciona (python o python3, ruta de la carpeta). Dentro de dos semanas lo agradecerás.

Realiza estas comprobaciones y anota el resultado exacto de cada una:

1. Abre una terminal y averigua tu versión de Python. Indica si el comando que funciona es python o python3.
2. Averigua la versión de pip usando la forma robusta con -m.
3. Entra en el REPL, calcula cuántos caracteres tiene el texto "Estudio Alba" y sal correctamente.
4. Muestra el directorio en el que está situada tu terminal.

Para cada situación, decide si usarías el REPL o un fichero .py, y justifica la elección:

1. Quieres comprobar rápidamente si "alta" > "baja" devuelve verdadero o falso.
2. Estás construyendo la pantalla de menú de TareaFácil, que tiene doce líneas.
3. Quieres enseñarle a Marta cómo funciona el programa dentro de dos semanas.
4. No recuerdas si len funciona con textos y quieres salir de dudas en cinco segundos.

Monta el proyecto desde cero siguiendo estos pasos:

1. Crea una carpeta tareafacil.
2. Dentro, crea tareafacil.py con una ficha de tarea de ejemplo (título, descripción, responsable, prioridad y estado) usando solo print. Usa datos ficticios coherentes con Estudio Alba.
3. Crea un README.md con el nombre del proyecto, una frase de descripción y el comando exacto para ejecutarlo.
4. Crea un entorno virtual llamado .venv y actívalo.
5. Ejecuta el programa y comprueba la salida.

Solución 1.

1. python --version o python3 --version, según el sistema. Salida del estilo Python 3.12.3. En Windows suele funcionar python; en macOS y Linux, casi siempre python3.
2. python -m pip --version, con salida parecida a pip 24.0 from /usr/lib/python3/dist-packages/pip (python 3.12). La forma con -m es preferible porque garantiza que el pip usado corresponde al Python que estás ejecutando.
3. Sesión completa:

Son 12 caracteres: 7 de «Estudio», 4 de «Alba» y el espacio. El espacio cuenta como carácter, cosa que sorprende a mucha gente.

4. pwd en cualquiera de los tres sistemas (también funciona en PowerShell).

Solución 2.

1. REPL. Es una comprobación puntual de un segundo que no necesita quedar guardada. (Por cierto: devuelve False, porque en la comparación alfabética la a de «alta» va antes que la b de «baja».)
2. Fichero. Es código del programa: tiene que persistir, poder modificarse y volver a ejecutarse muchas veces.
3. Fichero. Solo un fichero se puede guardar, ejecutar cuando haga falta y pasar a otra persona. Lo escrito en el REPL desaparece al salir.
4. REPL. Duda inmediata, respuesta inmediata: len("hola") devuelve 4. Sí funciona con textos.

Solución 3.

Contenido de tareafacil.py:

Contenido de README.md:

Comandos de terminal, situado en la carpeta tareafacil:

Si al ejecutar ves la ficha por pantalla y el prompt muestra (.venv), el proyecto está correctamente montado.

Nota sobre el resultado: fíjate en lo tosco que es escribir una ficha con print línea a línea. Si mañana quieres una segunda tarea, hay que duplicar los diez print y editarlos a mano. Esa incomodidad es exactamente el problema que resuelven las variables, y es lo primero que veremos en el módulo 2.

Ya tienes puesto de trabajo. Un entorno de desarrollo son varias piezas colaborando: el intérprete de Python 3, un editor (VS Code, con la extensión de Microsoft y el intérprete seleccionado), la terminal —donde lo esencial es saber en qué carpeta estás— y el gestor de paquetes pip. Has aprendido a instalar y verificar Python en los tres sistemas, a distinguir el REPL (pruebas rápidas y volátiles) de la ejecución de un fichero .py (programas de verdad, que persisten), a organizar las carpetas de un proyecto pequeño y a aislar sus dependencias con venv.

Y, sobre todo, existe ya tareafacil.py: un fichero real, en tu disco, que ejecutas tú y que crecerá durante ocho módulos hasta convertirse en un gestor de tareas completo. Ahora mismo solo imprime texto fijo, y en la solución del último ejercicio has visto la primera limitación seria de ese enfoque: cambiar cualquier dato obliga a editar el código a mano.

Antes de empezar a resolverlo con código, falta una última pieza del módulo, y es la que separa a quien programa de quien copia código: pensar antes de escribir. En la siguiente lección, Del problema al algoritmo, veremos qué es un algoritmo y qué propiedades debe cumplir, cómo descomponer un problema en pasos, cómo expresarlo en pseudocódigo y en diagramas de flujo, y cómo comprobarlo a mano con una prueba de escritorio. Lo aplicaremos a dos operaciones concretas de TareaFácil: registrar una tarea nueva y decidir qué tarea atiende Marta primero.