Saltearse al contenido

Primeros pasos

Antes de aprender sintaxis hay que tener dónde escribirla. Este capítulo es el único puramente práctico de la parte: instalar, probar y ejecutar. Si ya tienes Python funcionando, sáltalo.

Dos sitios para escribir código: la consola, para probar una línea; el archivo, para construir un programa.

Los pasos son para Windows 11. Si usas macOS o Linux, mira la nota del final de esta sección.

Entra en python.org, abre la sección Downloads y descarga lo que la página ofrezca para Windows. Según el momento, será una de estas dos cosas, y las dos sirven:

  • El gestor de instalación (Python Install Manager). Es la vía que python.org recomienda desde Python 3.14: instalas el gestor y él descarga Python. Sigue sus pantallas y acepta lo que propone.
  • El instalador clásico, un .exe con el número de versión en el nombre. En su primera pantalla hay una casilla para añadir Python al PATH («Add python.exe to PATH»): márcala antes de pulsar «Install Now». Esa casilla es la que permite escribir python en la terminal; viene desmarcada y es el olvido más frecuente.

Cualquier versión 3.11 o posterior vale para este manual. Los ejemplos están probados con Python 3.13.

Es el editor: el programa donde se escribe el código. Descárgalo de code.visualstudio.com, instálalo y, dentro, abre el panel de Extensiones e instala la extensión Python (la publica Microsoft).

La terminal es una ventana donde se escriben órdenes para el sistema, una por línea. No es Python: es el sitio desde el que se arranca Python.

Pulsa la tecla Windows, escribe terminal y abre Terminal. En Windows 11 viene instalada y abre PowerShell; si no la encuentras, busca PowerShell directamente. Verás una línea parecida a esta, que es donde se escribe:

PS C:\Users\tu-nombre>

Escribe en la terminal y pulsa Enter:

Ventana de terminal
python --version

Debe responder con la versión instalada, algo como Python 3.13.7. Si no lo hace, es uno de estos tres casos:

Lo que ves Qué pasa Qué hacer
Se abre la Microsoft Store, o un mensaje dice que no se encontró Python y propone instalarlo desde la tienda Windows trae un atajo llamado python que no es Python: solo lleva a la tienda. Aparece cuando Python no está instalado o no está en el PATH Cierra la tienda y prueba py --version
py --version responde, pero python no Python está instalado, pero no en el PATH Usa py donde el manual diga python (por ejemplo, py primero.py), o reinstala marcando la casilla del PATH
«no se reconoce como nombre de un cmdlet…» con los dos La terminal estaba abierta antes de instalar, o la instalación no terminó Cierra la terminal y ábrela de nuevo. Si sigue igual, reinstala

py es el lanzador de Python para Windows: una orden corta que busca el Python instalado y lo arranca. Se instala junto con Python y funciona aunque el PATH esté mal, así que es el plan B de todo este capítulo.

Crea una carpeta para tus programas —por ejemplo python-civil dentro de Documentos— y en VS Code elige Archivo → Abrir carpeta. Todo lo que escribas se guardará ahí.

La terminal siempre está «dentro» de una carpeta, la que muestra antes del >, y solo ve los archivos de esa carpeta. Hay dos formas de colocarla en la tuya:

  • Desde VS Code: menú Terminal → Nuevo terminal. Se abre abajo, ya colocada en la carpeta abierta. Es la más cómoda.
  • Desde el Explorador de archivos: clic derecho en un hueco vacío de la carpeta y Abrir en Terminal.

Y para moverse a mano hay una orden, cd (change directory):

Ventana de terminal
cd python-civil # entra en una carpeta que está dentro de la actual
cd .. # sube a la carpeta de arriba
dir # lista lo que hay en la carpeta actual

En macOS, instala Python con el instalador de python.org; en Linux suele venir instalado. En los dos, la terminal es la aplicación Terminal y la orden se llama python3: python3 --version, python3 primero.py. Donde este manual escriba python, escribe python3. No hay casilla del PATH ni lanzador py.

Escribe python en la terminal y pulsa Enter. La línea deja de empezar por PS C:\…> y aparece el símbolo >>>: ya no hablas con Windows, hablas con Python. Estás en el REPL (leer, evaluar, imprimir, repetir), y cada línea se ejecuta al pulsar Enter. Los >>> los pone Python: no se escriben.

>>> 2 + 3
5
>>> "hola" * 3
'holaholahola'
>>> salir = "no" # esto no hace nada visible

El REPL es para probar: una fórmula, una función, un módulo. No guarda nada al cerrar, y no sirve para escribir un programa de cien líneas.

Para salir, escribe exit() y pulsa Enter: funciona en cualquier sistema y en cualquier versión. Con el teclado, en Windows es Ctrl+Z y después Enter; Ctrl+D es el atajo de macOS y Linux. Al salir vuelve el PS C:\…> de la terminal.

En VS Code, con tu carpeta abierta, crea un archivo nuevo (Archivo → Nuevo archivo), guárdalo como primero.py y escribe:

luz = 6.0
carga = 20.0
momento = carga * luz ** 2 / 8
print(f"Momento: {momento} kN·m")

Guarda (Ctrl+S) y ejecútalo. Hay dos formas, y conviene conocer las dos:

  • Con el botón: el triángulo ▷ de arriba a la derecha del editor (Run Python File).
  • Desde la terminal, colocada en la carpeta del archivo:
Ventana de terminal
python primero.py

En los dos casos el resultado aparece en la terminal:

Momento: 90.0 kN·m

Ese es un programa: texto guardado, ejecutado por el intérprete, con un resultado.

Si en lugar del resultado la terminal dice can't open file … No such file or directory, Python funciona pero la terminal está en otra carpeta: ve a la del archivo con cd y repite.

En Python, lo que está dentro de un bloque se marca con espacios, no con llaves:

if momento > 100:
print("revisar")
print("aviso enviado")
print("fin")

Las dos primeras líneas están dentro del if; la tercera no. Cuatro espacios es la convención; mezclar tabuladores y espacios produce el error TabError, que parece misterioso y no lo es.

Tipo Cuándo aparece Ejemplo
SyntaxError Antes de ejecutar nada print("hola" (falta el paréntesis)
NameError Al ejecutar esa línea print(nombre) sin haberlo definido

Python señala la línea con un cursor ^ bajo el punto exacto. Es la herramienta de diagnóstico más útil que tienes: léela de abajo arriba —el tipo de error, luego la línea, luego el código—.

Sin mirar la solución, predice qué imprime este programa y por qué la última línea no lleva sangría:

luz = 6.0
if luz > 5:
print("viga larga")
luz = luz * 1.1
print(luz)
Solución
viga larga
6.6000000000000005

La última línea no lleva sangría porque no está dentro del if: se ejecuta siempre. Las dos anteriores solo se ejecutan si la condición es verdadera.

El resultado tiene decimales raros porque 6.0 * 1.1 no es exactamente 6.6 en coma flotante. Es normal en Python y en casi todos los lenguajes. Para mostrarlo limpio basta un formato —print(f"{luz:.1f}") escribe 6.6—, que es lo primero del capítulo siguiente; el porqué está en la Parte I, capítulo 07.

  • Lott, S. F. Modern Python Cookbook, 3ª ed., capítulos 1 y 2.
  • Documentación oficial: Using Python.