Instalación, editor y primer programa

En esta lección vas a dejar todo listo para el resto del curso: instalar Python (con el instalador oficial o con uv), conocer las dos formas de ejecutar código (la consola interactiva y los archivos .py), configurar VS Code y correr tu primer programa. Al final vas a aprender algo que vas a usar todos los días: leer un mensaje de error sin asustarte.

Qué es Python

Python es un lenguaje de programación de propósito general: sirve para automatizar tareas, procesar datos, armar sitios web, scripts de sistema y mucho más. Es popular por dos motivos:

• Se lee casi como texto. Tiene pocas reglas de sintaxis y usa la indentación (los espacios al principio de la línea) para marcar bloques, así que el código suele quedar prolijo.
• Trae mucho incluido. La biblioteca estándar resuelve fechas, archivos, matemática, números aleatorios y decenas de cosas más sin instalar nada extra.

Python es un lenguaje interpretado: no hace falta compilar el programa antes de correrlo. Un programa llamado intérprete lee tu código y lo ejecuta línea por línea.

Instalar Python

Necesitás Python 3.12 o posterior. Tenés dos caminos: elegí uno.

Opción A: uv (recomendada)

uv es una herramienta que instala Python y maneja proyectos y dependencias. Es rápida y evita los problemas típicos de "tengo varias versiones de Python y no sé cuál se está usando".

En macOS y Linux, desde la terminal:

curl -LsSf https://astral.sh/uv/install.sh | sh

En Windows, desde PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Cerrá y volvé a abrir la terminal, y después instalá Python:

uv python install 3.12
uv run python --version

Si ves algo como Python 3.12.x, está listo. Si querés más detalle sobre uv, tenés la guía uv y entornos virtuales.

Opción B: instalador oficial

1. Entrá a python.org/downloads y bajá la última versión 3.x.
2. En Windows, en la primera pantalla del instalador marcá la casilla "Add python.exe to PATH" antes de hacer clic en Install Now. Si te la salteás, la terminal no va a encontrar Python.
3. En macOS, ejecutá el .pkg descargado. En Linux, casi todas las distribuciones ya traen Python 3; verificá la versión.

Verificá desde la terminal:

python3 --version

En Windows el comando suele ser python o py en vez de python3. A lo largo del curso vamos a escribir python3; si estás en Windows, reemplazalo por el que te funcione.

Cómo abrir la terminal: en Windows buscá "PowerShell" o "Terminal" en el menú Inicio; en macOS, abrí "Terminal" desde Spotlight (Cmd + Espacio); en Linux, suele estar en el menú de aplicaciones o con Ctrl + Alt + T.

Dos formas de ejecutar código

La consola interactiva (REPL)

El REPL (Read-Eval-Print Loop) es una consola donde escribís una línea, Python la ejecuta y te muestra el resultado al instante. Abrilo con python3 (o uv run python):

$ python3
Python 3.12.3
>>> 2 + 3
5
>>> "hola" * 3
'holaholahola'
>>> 10 / 4
2.5
>>> exit()

El >>> es el prompt: te indica que Python espera una instrucción. Para salir escribí exit() (o Ctrl + D en macOS y Linux, Ctrl + Z y Enter en Windows).

El REPL es ideal para probar algo chico: cómo se comporta una operación, qué devuelve una función. Lo que escribís ahí se pierde al cerrarlo.

Un script: un archivo .py

Un script es un archivo de texto con extensión .py que contiene instrucciones. Python lo ejecuta de arriba hacia abajo. Es la forma normal de escribir programas: queda guardado, lo podés corregir y volver a correr.

El editor: VS Code

Podés escribir Python en cualquier editor de texto, pero conviene uno que te ayude. Recomendamos Visual Studio Code, gratuito y multiplataforma:

1. Instalalo desde la web oficial.
2. Abrí la sección de extensiones (el ícono de cuadraditos en la barra lateral) e instalá la extensión Python publicada por Microsoft.
3. Creá una carpeta para el curso, por ejemplo curso-python, y abrila con File → Open Folder.
4. Abrí la terminal integrada con Terminal → New Terminal. Esa terminal ya arranca parada en la carpeta del curso.

Con la extensión vas a tener colores en el código, autocompletado y subrayado de errores antes de ejecutar. Si preferís otro editor (PyCharm, Cursor, el IDLE que viene con Python), sirve igual.

Tu primer programa

Creá un archivo hola.py dentro de la carpeta del curso con este contenido:

print("Hola, mundo")
print("Estoy aprendiendo Python")
print(7 * 6)

Ejecutalo desde la terminal:

python3 hola.py

O, si instalaste con uv:

uv run hola.py

La salida es:

Hola, mundo
Estoy aprendiendo Python
42

Qué pasó:

• print(...) es una función que muestra en pantalla lo que le pasás entre paréntesis. Python trae muchas funciones listas para usar; print es la primera que vas a conocer.
• "Hola, mundo" es un string (texto). Va entre comillas dobles o simples.
• 7 * 6 es una operación. Python la calcula y print muestra el resultado.
• Las líneas se ejecutan en orden, de arriba hacia abajo.

Comentarios

Todo lo que viene después de un # en una línea es un comentario: Python lo ignora. Sirve para dejar notas a quien lea el código (incluido vos dentro de un mes).

# Este programa saluda
print("Hola")  # también se puede comentar al final de una línea

Hola

En este curso vamos a usar comentarios para mostrarte la salida esperada de una línea, así: print(2 + 2) # 4.

Cómo leer un error

Tarde o temprano (más temprano que tarde) vas a ver un error. Es normal y es información, no un castigo. Creá error.py:

print("Arranca el programa")
print("Total:", 100 / 0)
print("Esto no se llega a ejecutar")

Al correrlo vas a ver algo así:

Arranca el programa
Traceback (most recent call last):
  File "/Users/vos/curso-python/error.py", line 2, in <module>
    print("Total:", 100 / 0)
                    ~~~~^~~
ZeroDivisionError: division by zero

Eso es un traceback. Se lee de abajo hacia arriba:

1. La última línea dice qué pasó: el tipo de error (ZeroDivisionError) y un mensaje (division by zero, división por cero).
2. Arriba te dice dónde: el archivo, el número de línea (line 2) y el código de esa línea, con marcas ^ señalando la parte exacta.
3. El programa se detiene en el error: la tercera línea nunca se ejecutó.

Cuando el programa es más grande, el traceback tiene varias entradas File ..., una por cada lugar por el que pasó la ejecución. La última entrada suele ser la más útil, aunque el problema a veces está en una de las anteriores.

Hay otro tipo de error que aparece antes de ejecutar: el SyntaxError, cuando el código está mal escrito. Por ejemplo, si te olvidás de cerrar un paréntesis:

  File "/Users/vos/curso-python/hola.py", line 1
    print("Hola"
         ^
SyntaxError: '(' was never closed

En ese caso no se ejecuta ninguna línea, ni siquiera las que estaban bien.

Usar IA para entender errores

Las herramientas de IA (ChatGPT, Claude, Copilot) son muy buenas explicando errores. El riesgo es usarlas para pegar el código que te devuelven sin entenderlo: el programa anda, pero vos no aprendiste nada, y la próxima vez estás igual. Además, una IA a veces te da una solución que funciona pero es rebuscada, porque no aprovecha lo que el lenguaje ya trae resuelto. Saber qué herramientas tiene Python es justamente lo que te permite darte cuenta.

Una forma útil de usarla mientras aprendés:

1. Leé vos el traceback primero e intentá ubicar la línea y el tipo de error.
2. Pegá el traceback y el fragmento de código, y pedí una explicación, no una solución: "explicame por qué pasa este error".
3. Corregí vos el código con lo que entendiste.
4. Si te propone código, no lo pegues hasta entender cada línea. Si alguna no la entendés, preguntá por esa línea.

Cómo encarar el curso

Algunos hábitos que ayudan mucho cuando estás arrancando:

• Escribí el código, no lo copies. Tipear los ejemplos (aunque sea lento) te obliga a mirar cada símbolo.
• Tomá notas a mano de las ideas clave y de lo que te costó. Lo que anotás lo recordás mejor.
• Anotá tus dudas concretas ("no entiendo por qué range(1, 5) no incluye el 5") en vez de "no entiendo los bucles". Una duda concreta se resuelve rápido.
• Practicá con las notificaciones apagadas. Programar pide concentración sostenida.
• Rompé el código a propósito. Sacá un paréntesis, cambiá un número, y mirá qué error aparece. Es la mejor forma de perderle el miedo a los tracebacks.

Errores comunes

• "python no se reconoce como un comando" (Windows): Python no quedó en el PATH. Reinstalá marcando "Add python.exe to PATH", probá con py, o usá uv.
• python3: can't open file 'hola.py': No such file or directory: la terminal no está parada en la carpeta donde guardaste el archivo. Usá la terminal integrada de VS Code con la carpeta abierta, o movete con cd ruta/a/la/carpeta.
• Escribir python3 hola.py dentro del REPL: si ves >>>, estás dentro de Python. Salí con exit() y ejecutá el comando en la terminal normal.
• Comillas "inteligentes": si copiás código de un documento de texto, a veces las comillas " se convierten en “ ” y Python da SyntaxError. Escribilas vos desde el teclado.
• Archivo sin guardar: VS Code marca con un punto en la pestaña los archivos con cambios sin guardar. Si corrés el script sin guardar, se ejecuta la versión vieja.

Practicá

1. Creá presentacion.py que imprima tres líneas: tu nombre, tu ciudad y el resultado de 365 * 24 (las horas de un año).
2. Abrí el REPL y probá: 15 // 4, 15 % 4, 2 ** 10 y "ab" + "cd". Anotá qué hace cada operación antes de seguir a la lección 2.
3. Escribí un programa con un error a propósito en la línea 3 (por ejemplo print(10 / 0)) y otras dos líneas que sí funcionen antes. Ejecutalo y respondé: ¿qué líneas se ejecutaron?, ¿qué número de línea indica el traceback?, ¿cuál es el tipo de error?

Soluciones

Ejercicio 1:

print("Ana")
print("Rosario")
print(365 * 24)

Ana
Rosario
8760

Ejercicio 2: 15 // 4 da 3 (división entera: cuántas veces entra el 4 en el 15); 15 % 4 da 3 (el resto de esa división); 2 ** 10 da 1024 (potencia: 2 a la 10); "ab" + "cd" da 'abcd' (unir dos textos). En la lección 2 las vemos en detalle.

Ejercicio 3:

print("Línea 1")
print("Línea 2")
print(10 / 0)

Se ejecutan las líneas 1 y 2. El traceback marca line 3 y el tipo de error es ZeroDivisionError.

Resumen

• Python es un lenguaje interpretado y de propósito general; el curso usa la versión 3.12 o posterior.
• Podés instalarlo con uv (recomendado) o con el instalador oficial; en Windows, marcá "Add python.exe to PATH".
• El REPL sirve para probar cosas rápidas; los scripts .py son la forma de escribir programas que se guardan.
• Un script se corre con python3 archivo.py o uv run archivo.py, y se ejecuta de arriba hacia abajo.
• print() muestra cosas en pantalla; # empieza un comentario.
• Un traceback se lee de abajo hacia arriba: tipo de error, mensaje, y después archivo y línea.
• Usá la IA para que te explique errores, no para pegar código que no entendés.