Cómo instalar Python en Windows 11 y configurarlo correctamente

Preparar Windows para programar en Python

Python es uno de los lenguajes más utilizados del mundo. Se usa para automatizar tareas, analizar datos, entrenar modelos de inteligencia artificial, desarrollar aplicaciones web y escribir herramientas de línea de comandos. A diferencia de macOS y de la mayoría de distribuciones Linux, Windows no incluye Python de serie, así que el primer paso para empezar a trabajar con él es instalarlo y configurarlo correctamente.

Instalar Python en Windows parece sencillo, y en general lo es, pero hay detalles que provocan muchos dolores de cabeza a quien empieza: el comando python que abre la Microsoft Store en lugar de ejecutar el intérprete, pip que no se reconoce, varias versiones que entran en conflicto o un entorno virtual que PowerShell se niega a activar. Casi todos estos problemas tienen que ver con la variable de entorno PATH y con cómo se ha instalado Python.

Además, la forma oficial de instalar Python en Windows ha cambiado. Desde 2025, el proyecto Python ofrece el Python install manager, una herramienta que instala y gestiona varias versiones del lenguaje y que se está convirtiendo en el método recomendado. El instalador ejecutable tradicional sigue disponible para Python 3.15, la versión estable más reciente, pero dejará de publicarse a partir de Python 3.16.

En esta guía veremos cómo comprobar si ya tienes Python, cómo instalarlo con el nuevo gestor y con el instalador clásico, cómo revisar y corregir el PATH, cómo instalar paquetes con pip, cómo crear entornos virtuales y cómo resolver los errores más frecuentes. Las instrucciones están probadas con Windows 11, cuya versión actual es la 26H2, y son válidas también para Windows 10.

Comprobar si Python ya está instalado

Antes de instalar nada, conviene saber si ya tienes Python en el equipo. Abre una terminal: puedes usar Windows Terminal, PowerShell o el Símbolo del sistema. La forma más rápida es pulsar Win + X y elegir Terminal.

Ejecuta el siguiente comando:

python --version

Si Python está instalado y accesible, verás su versión:

Python 3.15.0

Si no lo está, pueden ocurrir dos cosas. Puede aparecer un error indicando que el comando no se reconoce:

python : The term 'python' is not recognized as the name of a cmdlet, function, script file, or operable program.

O, en muchas instalaciones de Windows, aparecerá este mensaje, o se abrirá directamente la Microsoft Store:

Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings > Apps > Advanced app settings > App execution aliases.

Este segundo caso se debe a los alias de ejecución de aplicaciones de Windows, unos accesos directos que el sistema incluye para python.exe y python3.exe y que redirigen a la tienda cuando Python no está instalado. Volveremos a ellos en la sección de errores.

También puedes comprobar si existe el lanzador py, que se instala con Python en Windows, y ver qué ejecutables encuentra el sistema:

py --version
where.exe python

C:\Users\laura\AppData\Local\Microsoft\WindowsApps\python.exe

Si la única ruta que aparece está dentro de WindowsApps y al ejecutarla se abre la tienda, Python no está instalado realmente.

Qué ha cambiado: el Python install manager

Durante muchos años, instalar Python en Windows consistía en descargar un archivo .exe desde la web oficial y seguir un asistente. Ese método funciona, pero tiene limitaciones: cada versión se instala por separado, actualizar implica descargar un nuevo instalador y gestionar varias versiones a la vez exige configurar el PATH a mano.

Para resolverlo, el proyecto Python aprobó en 2025 la propuesta PEP 773, que introduce el Python install manager para Windows. Es una aplicación que se instala una vez y que proporciona los comandos py, python, python3 y pymanager para instalar, listar, ejecutar y eliminar versiones de Python.

Sus principales ventajas son estas:

• Instala cualquier versión de Python desde la 3.5 con un solo comando.
• Permite tener varias versiones a la vez y elegir cuál ejecutar.
• Se actualiza automáticamente cuando se publican nuevas versiones del gestor.
• Configura de forma coherente los comandos y el PATH.
• Ofrece también variantes especiales, como las compilaciones sin GIL, la distribución embebible o los símbolos de depuración.

La versión actual del gestor es la 26.4, publicada en octubre de 2026, que incluye Python 3.15.0 para las arquitecturas x64 y ARM64. Requiere Windows 10 o posterior, o Windows Server 2022.

El instalador .exe tradicional sigue publicándose para Python 3.15, pero dejará de existir a partir de Python 3.16. Por eso, si vas a instalar Python hoy, lo recomendable es empezar ya con el nuevo gestor.

Instalar Python con el install manager

Hay tres formas de instalar el gestor. La recomendada para la mayoría de usuarios es la Microsoft Store: busca Python install manager en la tienda, o abre su página desde la sección de descargas para Windows de la web oficial de Python, y pulsa Obtener. La tienda se encarga también de las actualizaciones.

La segunda opción es WinGet, el gestor de paquetes de Windows, que permite hacerlo desde la terminal:

winget install 9NQ7512CXL7T

La tercera es descargar el paquete MSIX directamente desde la web oficial de Python y abrirlo con doble clic. Existe además un paquete MSI pensado para administradores y despliegues automatizados, sin interfaz gráfica y que requiere permisos de administrador.

Si tenías instalado el antiguo lanzador py del instalador clásico, desinstálalo antes desde Configuración, en Aplicaciones instaladas, porque ambos usan el mismo comando py y entrarían en conflicto.

La primera vez que ejecutes py o python, el gestor lanzará un asistente de configuración que revisa el sistema y propone los ajustes necesarios, como añadir al PATH la carpeta de los alias de versión o habilitar las rutas largas. Puedes volver a ejecutarlo en cualquier momento:

py install --configure

Si todavía no tienes ninguna versión de Python, el gestor te ofrecerá instalar la última versión estable, o puedes hacerlo tú mismo con py install seguido de la versión deseada.

Gestionar versiones con el comando py

El comando py es el centro del nuevo gestor. Estas son las operaciones más habituales.

Listar las versiones instaladas:

py list

Tag                  Name                       Managed By  Version  Alias
3.15[-64]           Python 3.15.0              PythonCore  3.15.0   python3.15.exe, pythonw3.15.exe

Ver todas las versiones disponibles para instalar:

py list --online

Instalar una versión concreta. Es útil cuando un proyecto exige una versión anterior, por ejemplo porque alguna librería todavía no es compatible con la más reciente:

py install 3.14

Ejecutar Python con una versión específica, usando su etiqueta:

py -V:3.14 --version
py -V:3.15 script.py

Actualizar las versiones instaladas a su última revisión de mantenimiento:

py install --upgrade 3.14

Y desinstalar una versión que ya no necesitas:

py uninstall 3.14

Cuando ejecutas simplemente python o py, el gestor usa la versión más reciente instalada o la que hayas configurado como predeterminada. Si un script incluye al principio una línea shebang como #!/usr/bin/env python3.14, el gestor la respeta y usa esa versión.

Por defecto, los comandos globales son python, python3, py y pymanager. Los alias específicos de versión, como python3.14.exe, se generan en una carpeta aparte que el asistente de configuración te ofrece añadir al PATH.

Método alternativo: el instalador clásico

Si prefieres el instalador tradicional, o necesitas instalar Python en un equipo sin acceso a la Microsoft Store, puedes seguir usándolo mientras esté disponible para la versión que necesites.

Descárgalo desde la sección de descargas para Windows de la web oficial de Python. Elige el instalador de 64 bits, o el de ARM64 si tu equipo usa un procesador ARM, como los portátiles con chips Snapdragon. Ejecútalo y sigue estos pasos:

1. En la primera pantalla, marca la casilla para añadir python.exe al PATH. Es la opción más importante y la causa de la mayoría de problemas cuando se olvida.
2. Elige Personalizar instalación en lugar de Instalar ahora, para revisar las opciones.
3. En las características opcionales, deja marcadas la documentación, pip, tcl/tk e IDLE, y el lanzador py. Los símbolos y binarios de depuración solo son necesarios si vas a depurar el propio intérprete.
4. En las opciones avanzadas, marca la opción de añadir Python a las variables de entorno y la de precompilar la biblioteca estándar. Si instalas para todos los usuarios, la ruta por defecto será C:\Program Files\Python315; si lo haces solo para tu usuario, será C:\Users\<usuario>\AppData\Local\Programs\Python\Python315. Anota la ruta, porque puede hacerte falta más adelante.
5. Pulsa Instalar y espera a que termine.
6. Al final, si aparece la opción de deshabilitar el límite de longitud de las rutas, acéptala.

El instalador clásico también puede usarse de forma silenciosa, algo útil para automatizar la configuración de varios equipos:

.\python-3.15.0-amd64.exe /quiet InstallAllUsers=0 PrependPath=1 Include_test=0

Recuerda que este método dejará de estar disponible a partir de Python 3.16, por lo que para nuevas instalaciones es preferible el gestor.

Verificar la instalación

Cierra todas las terminales abiertas y abre una nueva, porque los cambios en el PATH solo se aplican a las ventanas que se inician después de la instalación. Después ejecuta:

python --version
pip --version
py list

Python 3.15.0

El segundo comando mostrará la versión de pip y la carpeta desde la que se ejecuta, que dependerá del método de instalación. Lo importante es que los comandos respondan sin errores.

Para confirmar que todo funciona, abre el intérprete interactivo y ejecuta unas líneas:

python

>>> import sys, platform
>>> print(sys.version.split()[0], platform.system(), platform.machine())
3.15.0 Windows AMD64
>>> exit()

Revisar y corregir el PATH

La variable de entorno PATH contiene la lista de carpetas en las que Windows busca los ejecutables cuando escribes un comando. Si la carpeta de Python no está en ella, la terminal no encontrará python ni pip. Saber agregar Python al PATH manualmente es útil cuando la instalación no lo ha hecho o cuando algo se ha desconfigurado.

Para revisarlo desde la interfaz gráfica:

1. Pulsa Win y busca Editar las variables de entorno del sistema, o Editar las variables de entorno de esta cuenta.
2. En la ventana de Propiedades del sistema, pulsa Variables de entorno.
3. En la sección de variables de usuario, selecciona Path y pulsa Editar.
4. Comprueba que aparecen la carpeta raíz de Python y su subcarpeta Scripts, donde se instalan pip y las herramientas de los paquetes.
5. Si faltan, añádelas con Nuevo, acepta todas las ventanas y abre una terminal nueva.

Con el instalador clásico para un solo usuario, las rutas tendrán este aspecto:

C:\Users\laura\AppData\Local\Programs\Python\Python315\
C:\Users\laura\AppData\Local\Programs\Python\Python315\Scripts\

También puedes consultar el PATH desde PowerShell, mostrando cada carpeta en una línea:

$env:Path -split ';' | Select-String -Pattern 'Python'

Y comprobar qué ejecutable se usa realmente cuando escribes python:

Get-Command python | Select-Object -ExpandProperty Source

El orden de las carpetas importa: Windows usa el primer ejecutable que encuentra. Si la carpeta WindowsApps, donde están los alias de la tienda, aparece antes que la de Python, el comando seguirá abriendo la Microsoft Store. En ese caso, sube la carpeta de Python en la lista o desactiva los alias, como veremos más adelante.

Habilitar las rutas largas

Windows limita tradicionalmente la longitud de las rutas de archivo a 260 caracteres. Algunos paquetes de Python, sobre todo en proyectos de ciencia de datos y aprendizaje automático, crean estructuras de carpetas muy profundas que superan ese límite y hacen fallar la instalación con errores difíciles de interpretar.

Tanto el gestor como el instalador clásico ofrecen habilitar las rutas largas durante la configuración. Si no lo hiciste, puedes activarlo desde PowerShell ejecutado como administrador:

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
  -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

El cambio es seguro y lo recomienda la propia documentación de Python. Las aplicaciones que no admiten rutas largas siguen funcionando igual que antes.

Instalar paquetes con pip

pip es el gestor de paquetes de Python y se instala junto con el intérprete. Permite descargar librerías desde PyPI, el repositorio oficial de paquetes de Python, que contiene cientos de miles de proyectos.

La forma más fiable de usarlo es llamarlo a través del intérprete, con python -m pip. Así te aseguras de que los paquetes se instalan para la misma versión de Python que vas a ejecutar, algo importante cuando hay varias:

python -m pip install requests
python -m pip list
python -m pip install --upgrade pip

Un pequeño script para comprobar que el paquete funciona:

# clima.py
import requests

respuesta = requests.get(
    "https://api.open-meteo.com/v1/forecast",
    params={"latitude": 40.42, "longitude": -3.70, "current": "temperature_2m"},
    timeout=10,
)
datos = respuesta.json()
print(f"Temperatura actual en Madrid: {datos['current']['temperature_2m']} °C")

python clima.py

Temperatura actual en Madrid: 18.4 °C

Instalar paquetes directamente en la instalación global de Python funciona, pero no es buena idea a medio plazo: los distintos proyectos acaban necesitando versiones incompatibles de la misma librería. La solución son los entornos virtuales.

Crear un entorno virtual por proyecto

Un entorno virtual es una carpeta que contiene una copia aislada del intérprete y sus propios paquetes. Cada proyecto tiene el suyo, de modo que puedes usar una versión de Django en uno y otra distinta en otro sin conflictos. Aprender a crear un entorno virtual es probablemente el hábito más útil para trabajar con Python.

Python incluye el módulo venv para ello:

mkdir gastos-mensuales
cd gastos-mensuales
python -m venv .venv

La estructura resultante es esta:

gastos-mensuales
└── .venv
    ├── Include
    ├── Lib
    │   └── site-packages
    ├── Scripts
    │   ├── activate
    │   ├── activate.bat
    │   ├── Activate.ps1
    │   ├── pip.exe
    │   └── python.exe
    └── pyvenv.cfg

Para activarlo en PowerShell:

.\.venv\Scripts\Activate.ps1

Y en el Símbolo del sistema:

.venv\Scripts\activate.bat

Al activarlo, el indicador de la terminal muestra el nombre del entorno, y los comandos python y pip apuntan a los de la carpeta .venv:

(.venv) PS C:\Users\laura\gastos-mensuales>

A partir de aquí, todo lo que instales quedará dentro del proyecto. Es habitual guardar la lista de dependencias en un archivo para que otras personas puedan reproducir el entorno:

python -m pip install pandas openpyxl
python -m pip freeze > requirements.txt

Para salir del entorno, ejecuta deactivate. Y recuerda añadir la carpeta .venv a tu archivo .gitignore, porque no debe subirse al repositorio.

Elegir un editor para programar

Con Python instalado, necesitas un editor cómodo. Las opciones más extendidas son estas:

• Visual Studio Code, gratuito y muy popular, con la extensión oficial de Python de Microsoft, que añade autocompletado, depuración, ejecución de pruebas y detección automática de entornos virtuales.
• PyCharm, el IDE de JetBrains especializado en Python, con herramientas avanzadas de refactorización y análisis.
• IDLE, el editor sencillo que se instala con Python, suficiente para pequeños scripts y para aprender.

En Visual Studio Code, tras instalar la extensión, abre la carpeta del proyecto y usa la paleta de comandos con Ctrl + Shift + P para ejecutar Python: Select Interpreter y elegir el intérprete de tu carpeta .venv. A partir de ese momento, el editor y su terminal integrada usarán el entorno del proyecto.

Alternativas a la instalación nativa

La instalación nativa es la opción más directa, pero no la única. Según el tipo de trabajo, puede interesarte alguna de estas alternativas.

WSL, el subsistema de Windows para Linux, permite ejecutar una distribución Linux como Ubuntu dentro de Windows. Es muy recomendable para desarrollo web y para proyectos que se desplegarán en servidores Linux, porque el entorno es idéntico al de producción y muchas herramientas funcionan mejor en Linux. Se instala con un solo comando:

wsl --install

Anaconda y Miniconda son distribuciones orientadas a la ciencia de datos que incluyen su propio gestor de paquetes y entornos, conda, capaz de instalar también dependencias que no son de Python, como librerías de C o CUDA.

uv es un gestor de paquetes y proyectos escrito en Rust, muy rápido, que se ha popularizado en los últimos años. Puede instalar versiones de Python, crear entornos virtuales y gestionar dependencias con un único programa:

uv python install 3.15
uv venv
uv pip install requests

Docker, por último, permite ejecutar Python en contenedores aislados, algo útil cuando se quiere reproducir exactamente el entorno de producción.

Errores comunes y cómo resolverlos

El comando python abre la Microsoft Store o muestra el mensaje Python was not found. Se debe a los alias de ejecución de aplicaciones. Ve a Configuración, Aplicaciones, Configuración avanzada de aplicaciones, Alias de ejecución de aplicaciones, y desactiva los de python.exe y python3.exe. Si usas el Python install manager, este se encarga de los alias y el asistente de configuración te avisará del problema.

El comando pip no se reconoce:

'pip' is not recognized as an internal or external command,
operable program or batch file.

La carpeta Scripts no está en el PATH. Añádela como vimos antes o, mejor aún, usa siempre python -m pip, que no depende de ella.

PowerShell no permite activar el entorno virtual:

.\.venv\Scripts\Activate.ps1 : File C:\Users\laura\gastos-mensuales\.venv\Scripts\Activate.ps1 cannot be loaded because running scripts is disabled on this system.

La política de ejecución de PowerShell bloquea los scripts. Permite los scripts locales para tu usuario:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Los paquetes instalados no se encuentran al ejecutar el script:

ModuleNotFoundError: No module named 'requests'

Has instalado el paquete para una versión de Python o un entorno distinto del que estás usando. Comprueba qué intérprete se ejecuta con python -c "import sys; print(sys.executable)", activa el entorno virtual correcto y vuelve a instalar con python -m pip install.

La instalación de un paquete falla con errores de compilación que mencionan Microsoft Visual C++. Algunos paquetes contienen extensiones en C y, si no hay una versión precompilada para tu versión de Python, intentan compilarlas. Suele ocurrir con versiones de Python muy recientes, para las que algunos paquetes todavía no han publicado binarios. Prueba con una versión anterior de Python mediante py install o instala las Build Tools de Visual Studio.

Los cambios en el PATH no surten efecto. Cierra todas las terminales, incluida la integrada en tu editor, y abre una nueva. En casos raros, cerrar sesión en Windows resuelve el problema.

Hay conflictos entre el lanzador py antiguo y el nuevo gestor. Desinstala el Python Launcher del instalador clásico desde Aplicaciones instaladas y vuelve a ejecutar py install --configure.

Desinstalar Python

Para eliminar una versión instalada con el gestor, usa py uninstall seguido de su etiqueta. Si quieres eliminarlo todo, incluidas todas las versiones, accesos directos y archivos en caché:

py uninstall --purge

Ten en cuenta que desinstalar el propio gestor desde Aplicaciones instaladas no elimina las versiones de Python que hayas instalado con él; por eso conviene ejecutar antes el comando anterior si quieres una limpieza completa.

Las versiones instaladas con el instalador clásico se eliminan desde Configuración, en Aplicaciones instaladas, buscando Python 3.x. Después, revisa el PATH y elimina las rutas que ya no existan, y borra si quieres la carpeta de caché de pip, situada en %LocalAppData%\pip\Cache.

Conclusiones

Instalar Python en Windows es un proceso rápido si se conocen los puntos delicados. El primer paso es comprobar si ya existe una instalación con python --version y py list, teniendo en cuenta que los alias de la Microsoft Store pueden dar la falsa impresión de que Python está presente.

El método recomendado hoy es el Python install manager, disponible en la Microsoft Store, con WinGet o como descarga directa. Proporciona el comando py para instalar, listar, ejecutar, actualizar y eliminar versiones, gestiona varias a la vez y se actualiza solo. El instalador ejecutable clásico sigue disponible para Python 3.15, pero dejará de publicarse con Python 3.16, así que conviene familiarizarse ya con el nuevo gestor.

Tras la instalación, verifica que python y pip responden, revisa el PATH si algo falla y habilita las rutas largas para evitar problemas con paquetes complejos. Usa python -m pip para instalar paquetes y crea un entorno virtual por proyecto con venv, un hábito que evita conflictos de dependencias.

Con un buen editor, como Visual Studio Code o PyCharm, y alternativas como WSL o uv para casos específicos, tendrás un entorno de desarrollo en Windows preparado para cualquier proyecto en Python.