Problemas comunes al instalar Python, VS Code y Jupyter Notebook (y cómo solucionarlos)

by EON Techin Jupyter Notebook, Python, Troubleshooting, Visual Studio Codeon Posted on

Instalar Python, Visual Studio Code y Jupyter Notebook suele ser sencillo, pero en muchos casos aparecen errores que impiden ejecutar scripts, abrir notebooks o detectar el intérprete. En esta guía encontrarás los problemas más frecuentes y cómo solucionarlos paso a paso.

1. Python no se reconoce en la terminal

Este error aparece cuando escribes python o python3 y recibes:

python: command not found

Causas comunes

  • Python no está instalado correctamente
  • La ruta no está en el PATH
  • Estás usando Windows y el instalador no añadió Python al sistema

Solución

A) Verifica instalación:

python3 --version
python --version

B) En Windows, reinstala Python marcando:

Add Python to PATH

C) En Linux, instala Python:

sudo apt update
sudo apt install python3 python3-pip -y

2. VS Code no detecta el intérprete de Python

Uno de los errores más comunes al abrir un proyecto es:

No Python interpreter found

Causas

  • No tienes instalada la extensión oficial de Python
  • VS Code no encuentra el ejecutable
  • Estás usando un entorno virtual sin activar

Solución

A) Instala la extensión oficial:

ms-python.python

B) Selecciona el intérprete manualmente:

Ctrl + Shift + P → Python: Select Interpreter

C) Activa tu entorno virtual:

source venv/bin/activate   # Linux / Mac
venv\Scripts\activate      # Windows

3. Jupyter Notebook no abre o queda cargando

Al ejecutar jupyter notebook puede quedarse congelado o no abrir el navegador.

Causas

  • Jupyter no está instalado en el entorno actual
  • Conflictos con versiones antiguas
  • Problemas con el navegador predeterminado

Solución

A) Reinstala Jupyter Notebook:

pip install --upgrade jupyter

B) Abre Jupyter manualmente:

jupyter notebook --no-browser

C) Copia la URL generada en la terminal y pégala en tu navegador.

4. Error “Kernel died” o “Kernel no se inicia”

Este error aparece cuando el kernel de Python se cierra inesperadamente.

Causas

  • Conflictos entre versiones de Python
  • Falta de dependencias
  • Entorno virtual corrupto

Solución

A) Reinstala ipykernel:

pip install --upgrade ipykernel
python3 -m ipykernel install --user

B) Crea un entorno virtual nuevo:

python3 -m venv venv
source venv/bin/activate
pip install jupyter

5. Error al ejecutar Python en un VPS

En servidores VPS es común ver errores como:

ModuleNotFoundError
Permission denied
python: command not found

Solución

A) Instala Python y pip:

sudo apt install python3 python3-pip -y

B) Instala dependencias del sistema:

sudo apt install build-essential libssl-dev libffi-dev python3-dev -y

C) Usa entornos virtuales:

python3 -m venv venv
source venv/bin/activate

6. VS Code no ejecuta scripts Python

Cuando presionas “Run” y no pasa nada, suele deberse a:

  • Extensión de Python mal configurada
  • Ruta del archivo con espacios
  • Problemas con el terminal integrado

Solución

A) Cambia el terminal predeterminado:

Ctrl + Shift + P → Terminal: Select Default Profile

B) Ejecuta manualmente:

python3 archivo.py

C) Reinstala la extensión de Python si es necesario.

🔧 Sección extra: Scripts de diagnóstico para Python, VS Code y Jupyter Notebook

Si después de instalar Python, VS Code o Jupyter Notebook sigues teniendo errores, puedes usar estos scripts de debug automático para detectar los problemas más comunes en tu entorno de desarrollo.

Incluyo dos versiones: una para Linux/macOS y otra para Windows PowerShell.

🐧 Script para Linux / macOS

Este script puede guardarse como python-debug-check.sh y ejecutarse con:

sudo bash python-debug-check.sh

✔ Cómo guardar el archivo en el servidor usando nano

Si estás trabajando directamente en tu VPS o servidor Linux, puedes crear y guardar el archivo usando nano, que es el editor más simple y compatible.

  1. Abre el archivo con nano:
nano python-debug-check.sh
  1. Pega dentro el siguiente contenido:
#!/bin/bash
# Script de diagnóstico rápido para Python, VS Code y Jupyter

echo "=== Diagnóstico Python / VS Code / Jupyter ==="
echo "Fecha: $(date)"
echo "----------------------------------------------"

# 1. Verificar Python
echo "[1] Verificando Python..."
python3 --version 2>/dev/null && echo "✔ Python3 detectado" || echo "❌ Python3 no está instalado"
python --version 2>/dev/null && echo "✔ Python detectado" || echo "❌ Python no está instalado"

# 2. Verificar pip
echo "[2] Verificando pip..."
pip3 --version 2>/dev/null && echo "✔ pip3 detectado" || echo "❌ pip3 no está instalado"

# 3. Verificar módulos esenciales
echo "[3] Módulos esenciales:"
modules=(jupyter ipykernel notebook)
for m in "${modules[@]}"; do
  python3 -c "import $m" 2>/dev/null && echo "✔ $m instalado" || echo "❌ Falta $m"
done

# 4. Verificar entorno virtual
echo "[4] Entorno virtual:"
if [[ "$VIRTUAL_ENV" != "" ]]; then
  echo "✔ Entorno virtual activo: $VIRTUAL_ENV"
else
  echo "❌ No hay entorno virtual activo"
fi

# 5. Verificar kernels de Jupyter
echo "[5] Kernels de Jupyter:"
jupyter kernelspec list 2>/dev/null || echo "❌ No se pudo obtener la lista de kernels"

# 6. Verificar VS Code
echo "[6] Verificando VS Code..."
code --version 2>/dev/null && echo "✔ VS Code detectado" || echo "❌ VS Code no está instalado"

# 7. Verificar extensión de Python en VS Code
echo "[7] Extensión de Python en VS Code:"
code --list-extensions | grep -q "ms-python.python" && echo "✔ Extensión instalada" || echo "❌ Extensión NO instalada"

echo "----------------------------------------------"
echo "Diagnóstico completado."
  1. Guarda el archivo en nano:
  • Ctrl + O → guardar
  • Enter → confirmar
  • Ctrl + X → salir
  1. Haz el archivo ejecutable:
chmod +x python-debug-check.sh
  1. Ejecuta el script:
sudo bash python-debug-check.sh

El script mostrará un diagnóstico completo del estado de Python, pip, Jupyter, kernels y VS Code en tu sistema Linux o macOS.

🪟 Script para Windows (PowerShell)

Si usas Windows, guarda este archivo como python-debug.ps1 y ejecútalo desde PowerShell.

Importante: Si al ejecutar el script aparecen errores como “The Try statement is missing its Catch or Finally block” o caracteres extraños como “Diagnóstico”, significa que el archivo se guardó con una codificación incorrecta.

✔ Solución recomendada (Notepad++ → Convertir a ANSI)

  1. Abre el archivo python-debug.ps1 en Notepad++.
  2. En el menú superior, ve a Codificación.
  3. Selecciona Convertir a ANSI.
  4. Vuelve a pegar el código.
  5. Guarda el archivo.

Esto elimina caracteres invisibles y corrige problemas de codificación que impiden que PowerShell ejecute el script correctamente.

📜 Script funcional (sin try/catch)

Write-Host "=== Diagnóstico Python / VS Code / Jupyter (Windows) ==="
Write-Host "Fecha: $(Get-Date)"
Write-Host "---------------------------------------------------------"

# 1. Verificar Python
Write-Host "`n[1] Verificando Python..."
$python = Get-Command python -ErrorAction SilentlyContinue
$python3 = Get-Command python3 -ErrorAction SilentlyContinue

if ($python) {
    python --version
    Write-Host "✔ Python detectado"
} elseif ($python3) {
    python3 --version
    Write-Host "✔ Python3 detectado"
} else {
    Write-Host "❌ Python no está instalado"
}

# 2. Verificar pip
Write-Host "`n[2] Verificando pip..."
$pip = Get-Command pip -ErrorAction SilentlyContinue
$pip3 = Get-Command pip3 -ErrorAction SilentlyContinue

if ($pip) {
    pip --version
    Write-Host "✔ pip detectado"
} elseif ($pip3) {
    pip3 --version
    Write-Host "✔ pip3 detectado"
} else {
    Write-Host "❌ pip no está instalado"
}

# 3. Verificar módulos esenciales
Write-Host "`n[3] Módulos esenciales:"
$modules = @("jupyter", "ipykernel", "notebook")

foreach ($m in $modules) {
    python -c "import $m" 2>$null
    if ($LASTEXITCODE -eq 0) {
        Write-Host "✔ $m instalado"
    } else {
        Write-Host "❌ Falta $m"
    }
}

# 4. Verificar kernels de Jupyter
Write-Host "`n[4] Kernels de Jupyter:"
jupyter kernelspec list 2>$null
if ($LASTEXITCODE -ne 0) {
    Write-Host "❌ No se pudo obtener la lista de kernels"
}

# 5. Verificar VS Code
Write-Host "`n[5] Verificando VS Code..."
$code = Get-Command code -ErrorAction SilentlyContinue

if ($code) {
    code --version
    Write-Host "✔ VS Code detectado"
} else {
    Write-Host "❌ VS Code no está instalado"
}

# 6. Verificar extensión de Python en VS Code
Write-Host "`n[6] Extensión de Python en VS Code..."
$extensions = code --list-extensions 2>$null

if ($LASTEXITCODE -ne 0) {
    Write-Host "❌ No se pudo verificar la extensión de VS Code"
} elseif ($extensions -match "ms-python.python") {
    Write-Host "✔ Extensión de Python instalada"
} else {
    Write-Host "❌ Extensión de Python NO instalada"
}

Write-Host "`n---------------------------------------------------------"
Write-Host "Diagnóstico completado."

🧠 Cómo usar el script en Windows

  1. Abre PowerShell como administrador.
  2. Ejecuta:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
  1. Ejecuta el script:
.\python-debug.ps1

El script mostrará un informe completo del estado de Python, pip, Jupyter, kernels y VS Code.

Conclusión

Python, VS Code y Jupyter Notebook son herramientas poderosas, pero su instalación puede generar errores si no están configuradas correctamente. Con esta guía podrás identificar y resolver los problemas más comunes sin perder tiempo. Si sigues estos pasos, tu entorno de desarrollo quedará funcionando de forma estable y lista para trabajar.