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.
En una línea
Sección titulada «En una línea»Dos sitios para escribir código: la consola, para probar una línea; el archivo, para construir un programa.
Instalar
Sección titulada «Instalar»Los pasos son para Windows 11. Si usas macOS o Linux, mira la nota del final de esta sección.
1. Python
Sección titulada «1. Python»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
.execon 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 escribirpythonen 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.
2. Visual Studio Code
Sección titulada «2. Visual Studio Code»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).
3. Abrir una terminal
Sección titulada «3. Abrir una terminal»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>4. Comprobar
Sección titulada «4. Comprobar»Escribe en la terminal y pulsa Enter:
python --versionDebe 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.
Una carpeta para trabajar
Sección titulada «Una carpeta para trabajar»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):
cd python-civil # entra en una carpeta que está dentro de la actualcd .. # sube a la carpeta de arribadir # lista lo que hay en la carpeta actualEn macOS y Linux
Sección titulada «En macOS y Linux»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.
La consola (REPL)
Sección titulada «La consola (REPL)»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 + 35>>> "hola" * 3'holaholahola'>>> salir = "no" # esto no hace nada visibleEl 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.
El archivo
Sección titulada «El archivo»En VS Code, con tu carpeta abierta, crea un archivo nuevo (Archivo → Nuevo archivo), guárdalo como primero.py y escribe:
luz = 6.0carga = 20.0momento = carga * luz ** 2 / 8print(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:
python primero.pyEn los dos casos el resultado aparece en la terminal:
Momento: 90.0 kN·mEse 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.
La sangría es la estructura
Sección titulada «La sangría es la estructura»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.
Los dos errores del principio
Sección titulada «Los dos errores del principio»| 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—.
La trampa
Sección titulada «La trampa»Ejercicio
Sección titulada «Ejercicio»Sin mirar la solución, predice qué imprime este programa y por qué la última línea no lleva sangría:
luz = 6.0if luz > 5: print("viga larga") luz = luz * 1.1print(luz)Solución
viga larga6.6000000000000005La ú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.
Referencias
Sección titulada «Referencias»- Lott, S. F. Modern Python Cookbook, 3ª ed., capítulos 1 y 2.
- Documentación oficial: Using Python.
Capítulos relacionados
Sección titulada «Capítulos relacionados»- 05 · Variables, números y texto: qué se puede escribir dentro del archivo.
- 06 · Decisiones y repeticiones: el
ifdel ejemplo, en serio.