Instalar Python bien: intérprete, PATH, venv y VSCode

Configuración real de entorno Python: instalación correcta, validación del intérprete, creación de entornos virtuales y selección en VSCode sin errores típicos.

Instalar Python no es solo "descargar y siguiente": en entornos profesionales necesitas controlar versión, PATH y aislamiento de dependencias.

El error más común de principiantes es mezclar paquetes globales entre proyectos; se evita con entornos virtuales (`venv`).

VSCode no ejecuta automáticamente el Python correcto: debes elegir el intérprete del proyecto.

Si no validas ruta de ejecutable (`sys.executable`) puedes creer que instalaste algo en tu proyecto cuando realmente fue al entorno global.

  • Antes de escribir código, confirma que el sistema ve Python y su versión.
  • En Windows suele funcionar `py --version`; en Linux/macOS suele usarse `python3 --version`. Lo relevante es conocer el comando correcto de tu máquina y mantenerlo consistente.
  • Si el comando no existe, Python no está en PATH o no está instalado. Resolver esto primero evita horas de frustración en VSCode y terminal.
  • Trabaja idealmente con Python 3.11+ o 3.12+ para compatibilidad actual de librerías.
  • Cada proyecto debe tener sus dependencias aisladas.

1) Verificar instalación y PATH

Antes de escribir código, confirma que el sistema ve Python y su versión.

En Windows suele funcionar `py --version`; en Linux/macOS suele usarse `python3 --version`. Lo relevante es conocer el comando correcto de tu máquina y mantenerlo consistente.

Si el comando no existe, Python no está en PATH o no está instalado. Resolver esto primero evita horas de frustración en VSCode y terminal.

Trabaja idealmente con Python 3.11+ o 3.12+ para compatibilidad actual de librerías.

2) Crear entorno virtual por proyecto

Cada proyecto debe tener sus dependencias aisladas.

`venv` crea una carpeta local con su propio ejecutable Python y su propio `pip`.

Eso evita conflictos como: un proyecto necesita `fastapi==0.109` y otro `fastapi==0.115`.

Nunca hagas `pip install` global salvo herramientas muy puntuales. En proyectos, siempre entorno activado.

3) Conectar VSCode con el intérprete correcto

VSCode debe apuntar al Python del `.venv` del proyecto.

Instala la extensión oficial de Python (`ms-python.python`).

Abre la paleta (`Ctrl+Shift+P`) y usa `Python: Select Interpreter` para elegir el ejecutable dentro de `.venv`.

Valida en código cuál es el ejecutable real para confirmar que no estás en global.

  • Si `Executable` no apunta a `.venv`, corrige intérprete en VSCode.
  • Si `pip install` falla, revisa si entorno está activado.
  • Guarda dependencias en `requirements.txt` para reproducibilidad.
Python
02

Instalar Python bien: intérprete, PATH, venv y VSCode

Configuración real de entorno Python: instalación correcta, validación del intérprete, creación de entornos virtuales y selección en VSCode sin errores típicos.

Código del tema: Automatizacion y codigo legible en Python

📘 Teoría

1) Verificar instalación y PATH

Antes de escribir código, confirma que el sistema ve Python y su versión.

1

En Windows suele funcionar `py --version`; en Linux/macOS suele usarse `python3 --version`. Lo relevante es conocer el comando correcto de tu máquina y mantenerlo consistente.

2

Si el comando no existe, Python no está en PATH o no está instalado. Resolver esto primero evita horas de frustración en VSCode y terminal.

3

Trabaja idealmente con Python 3.11+ o 3.12+ para compatibilidad actual de librerías.

Comandos de verificación
# Windows
py --version
py -m pip --version

# Linux / macOS
python3 --version
python3 -m pip --version

2) Crear entorno virtual por proyecto

Cada proyecto debe tener sus dependencias aisladas.

`venv` crea una carpeta local con su propio ejecutable Python y su propio `pip`.

Eso evita conflictos como: un proyecto necesita `fastapi==0.109` y otro `fastapi==0.115`.

Nunca hagas `pip install` global salvo herramientas muy puntuales. En proyectos, siempre entorno activado.

1

Crear entorno

Ejecuta este paso dentro de la carpeta del proyecto.

2

Activar entorno

Tras activarlo, `python` y `pip` apuntan al entorno local.

3) Conectar VSCode con el intérprete correcto

VSCode debe apuntar al Python del `.venv` del proyecto.

Instala la extensión oficial de Python (`ms-python.python`).

Abre la paleta (`Ctrl+Shift+P`) y usa `Python: Select Interpreter` para elegir el ejecutable dentro de `.venv`.

Valida en código cuál es el ejecutable real para confirmar que no estás en global.

  • Si `Executable` no apunta a `.venv`, corrige intérprete en VSCode.
  • Si `pip install` falla, revisa si entorno está activado.
  • Guarda dependencias en `requirements.txt` para reproducibilidad.
Auditoría rápida del intérprete en uso
import sys

print('Python version:', sys.version.split()[0])
print('Executable:', sys.executable)

🧪 Aprende probando

Ejemplo Ejemplo: comprobar entorno desde Python Script de diagnóstico para confirmar versión y ruta del intérprete activo.

🏁 Retos

Reto Reto: completar comando de creación de entorno Escribe el comando estándar para crear el entorno virtual local.

🧰 Recursos

Test

Comprueba tus conocimientos con un test sobre Python.

Test de Python

¿Qué es esto?

Soy Cristian Eslava y a veces hago webs para procrastinar yo y vosotros 😉.

Esta la hice en febrero de 2026 para facilitar el aprendizaje de mis alumnxs. Aprender desarrollo web practicando. La idea es que crezca semanalmente con nuevos temas, tests y retos.

Inspirado en MDN, en W3Schools, en Codepen, en el crack de Manz y en mil sitios de documentación sobre desarrollo web. Quería aportar además de bloques teóricos con ejemplos, la gamificación de los retos y el sistema de test que ya tenía en culTest .

Si te gustó, si no te gustó, si quieres saludarme, o invitarme a 🍻 no dudes en escribirme en cristianeslava@gmail.com .