Programación en Python con VS Code
Desea escribir código Python pero no está seguro de qué editor usar, o busca algo más ligero que PyCharm. Piense en VS Code como una navaja suiza: maneja Python, R, JavaScript y muchos otros lenguajes en un solo editor ligero. Este tutorial muestra cómo configurar Python en VS Code con características inteligentes como autocompletado de código, depuración interactiva y aplicaciones web.
Conceptos Clave
- Python Extension - Extensión de VS Code desarrollada por Microsoft que proporciona resaltado de sintaxis, depuración, ejecución de código y soporte para notebooks Jupyter
- Pylance - Servidor de lenguaje que proporciona IntelliSense rápido, verificación de tipos e importaciones automáticas para Python
- Virtual Environment - Entorno Python aislado para gestionar paquetes específicos del proyecto sin afectar el Python del sistema
- Streamlit - Biblioteca de Python para crear aplicaciones web interactivas con scripts simples de Python
Lo Que Necesitará
- Haber completado Primeros Pasos con VS Code
- Conexión a Internet para descargar Python y paquetes
- 15-20 minutos
Paso 1: Instalar Python
Necesita Python 3.11 o superior (lo mejor es la versión más reciente de python.org) para que se instalen las versiones más nuevas de paquetes como pandas y Streamlit.
- Windows:
- Vaya a python.org/downloads/windows y, debajo de la versión más reciente de Python 3, haga clic en Windows installer (64-bit) (no en el “install manager”)
- Ejecute el instalador
- Marque la casilla “Add python.exe to PATH” antes de hacer clic en Install Now
- Anote la ubicación de instalación (típicamente
C:\Users\YourName\AppData\Local\Programs\Python\Python312; el número coincide con su versión de Python)
- macOS:
- Descargue desde python.org y ejecute el instalador
- Cuando termine el instalador de python.org, abra Finder > Applications > Python 3.x y haga doble clic en Install Certificates.command (de lo contrario, cargar datos desde internet en el Paso 7 falla con
CERTIFICATE_VERIFY_FAILED) - O use Homebrew: abra Terminal y escriba
brew install python - Ruta de Homebrew:
/opt/homebrew/bin/python3(Apple Silicon) o/usr/local/bin/python3(Intel)
- Linux:
- Python generalmente viene preinstalado. Verifique la versión con
python3 --version - Si es necesario, instale vía gestor de paquetes:
sudo apt install python3 python3-pip python3-venv(Ubuntu/Debian)
- Python generalmente viene preinstalado. Verifique la versión con
Verifique la instalación abriendo una terminal y ejecutando python3 --version o python --version.
Paso 2: Instalar Extensiones de Python en VS Code
- Abra VS Code
- Haga clic en el ícono Extensions en la barra lateral izquierda (o haga clic en View > Extensions)
- Busque
ms-python.pythony haga clic en Install en la extensión Python de Microsoft - Pylance debería instalarse automáticamente con la extensión Python. Si no, busque
ms-python.vscode-pylancee instálela
La extensión Python incluye soporte para depuración, IntelliSense, formateo de código y notebooks Jupyter.
Paso 3: Crear Su Proyecto Python
- Cree una nueva carpeta en su computadora (por ejemplo,
my-python-project) - En VS Code, haga clic en File > Open Folder y seleccione su nueva carpeta
- Haga clic en File > New File… en el menú superior. Aparece una lista en la parte superior de la ventana: elija Python File
- Guarde el archivo como
analysis.pyhaciendo clic en File > Save
Paso 4: Seleccionar el Intérprete de Python
VS Code necesita saber qué instalación de Python usar.
- Haga clic en View en la barra de menú, luego Command Palette
- Escriba
Python: Select Interpretery selecciónelo - Elija la versión de Python que instaló (por ejemplo,
Python 3.12.xo similar) - El intérprete seleccionado aparece en la esquina inferior derecha de VS Code
Si no ve su instalación de Python, haga clic en Enter interpreter path y navegue hasta donde está instalado Python.
Paso 5: Crear un Entorno Virtual
Los entornos virtuales mantienen aisladas las dependencias de su proyecto.
- Haga clic en View en la barra de menú, luego Command Palette
- Escriba
Python: Create Environmenty selecciónelo - Elija Venv (entorno virtual integrado)
- Seleccione su intérprete de Python de la lista
- Espere a que VS Code cree el entorno (verá aparecer una carpeta
.venv) - VS Code activará automáticamente este entorno para su proyecto
Verá (.venv) en el prompt de su terminal cuando el entorno esté activo.
Paso 6: Instalar Paquetes Requeridos
- Abra una nueva terminal en VS Code haciendo clic en View > Terminal
- La terminal debería mostrar
(.venv)indicando que su entorno virtual está activo - Instale paquetes escribiendo este comando:
pip install pandas matplotlib streamlit
- Espere a que se complete la instalación (puede tomar 1-2 minutos)
Si (.venv) no aparece, el entorno no está activo. Haga clic en View > Command Palette, ejecute Python: Select Interpreter, luego elija el intérprete con ('.venv': venv) al lado.
Paso 7: Escribir Su Primer Script de Python
Escriba este código en analysis.py:
import pandas as pd
import matplotlib.pyplot as plt
# Load the iris dataset
url = "https://raw.githubusercontent.com/mwaskom/seaborn-data/master/iris.csv"
iris = pd.read_csv(url)
# View the first few rows
print(iris.head())
# Generate summary statistics
print("\nSummary Statistics:")
print(iris.describe())
# Create a histogram
plt.figure(figsize=(8, 6))
plt.hist(iris['sepal_length'], bins=20, color='steelblue', edgecolor='white')
plt.xlabel('Sepal Length (cm)')
plt.ylabel('Frequency')
plt.title('Distribution of Sepal Length')
plt.show()
- Guarde el archivo haciendo clic en File > Save
Paso 8: Ejecutar Código Python Interactivamente
- Con
analysis.pyabierto, haga clic en el botón ▶ Run Python File en la esquina superior derecha - O haga clic derecho en el editor y seleccione Run Python > Run Python File in Terminal
- Observe la salida en el panel de terminal
- Aparecerá una ventana de histograma mostrando su gráfico
- También puede seleccionar líneas específicas y presionar
Shift+Enterpara ejecutar solo esas líneas en una sesión interactiva de Python
Paso 9: Crear una Aplicación Simple de Streamlit
- Cree un nuevo archivo: haga clic en File > New File… y luego elija Python File en la lista de la parte superior de la ventana
- Guárdelo como
app.py - Escriba este código:
import streamlit as st
import pandas as pd
import matplotlib.pyplot as plt
st.title("Interactive Histogram")
# Sidebar slider
bins = st.sidebar.slider(
"Number of bins:",
min_value=5,
max_value=50,
value=30
)
# Load data
url = "https://raw.githubusercontent.com/mwaskom/seaborn-data/master/iris.csv"
iris = pd.read_csv(url)
# Create histogram
fig, ax = plt.subplots(figsize=(8, 6))
ax.hist(iris['sepal_length'], bins=bins, color='steelblue', edgecolor='white')
ax.set_xlabel('Sepal Length (cm)')
ax.set_ylabel('Frequency')
ax.set_title('Distribution of Sepal Length')
# Display in Streamlit
st.pyplot(fig)
- Guarde el archivo
- Abra la terminal y ejecute:
streamlit run app.py
- La primera vez que ejecute Streamlit, le pedirá un
Email:en la terminal. Simplemente presioneEnterpara omitirlo - La aplicación se abrirá en su navegador (generalmente en
http://localhost:8501) - Mueva el control deslizante en la barra lateral y observe la actualización instantánea del histograma
- Presione
Ctrl+Cen la terminal para detener la aplicación
Paso 10: Usar Autocompletado de Código e IntelliSense
- En
analysis.py, comience a escribiriris.en una nueva línea - Aparecerá un menú desplegable con todos los métodos y atributos disponibles
- Escriba
iris.gry observe la sugerencia degroupby() - Pase el cursor del mouse sobre
pd.read_csven su código existente - Un popup mostrará la firma de la función, parámetros y documentación
- Intente escribir
importy observe las sugerencias de nombres de paquetes de VS Code - Cuando escribe una llamada a función, IntelliSense muestra sugerencias de parámetros
- Cuando termine, borre las líneas incompletas que escribió en este paso (como
iris.greimport) y guarde el archivo, para que el script se ejecute sin errores en el siguiente paso
Paso 11: Probar la Depuración
- En
analysis.py, haga clic a la izquierda del número de línea 9 (la líneaprint(iris.head())) para establecer un punto de interrupción (aparecerá un punto rojo) - Haga clic en Run en la barra de menú, luego en Start Debugging
- Seleccione Python File cuando se le solicite
- La ejecución del código se pausará en el punto de interrupción
- Use la barra de herramientas de depuración para avanzar paso a paso por el código, inspeccionar variables y ver la pila de llamadas
- Haga clic en Run > Continue para reanudar la ejecución
Próximos Pasos
- Explore pandas para manipulación y análisis de datos
- Aprenda sobre notebooks Jupyter en VS Code para ciencia de datos interactiva
- Pruebe Flask o FastAPI para construir APIs web
- Instale Black para formateo automático de código
- Use pytest para escribir y ejecutar pruebas
Solución de Problemas
-
“Python is not recognized” en la terminal: Python no está en su PATH del sistema. En Windows, reinstale Python y marque “Add python.exe to PATH”. En Mac/Linux, use
python3en lugar depython. Reinicie VS Code después. -
No se encuentra el intérprete: Haga clic en el selector de intérprete en la esquina inferior derecha de VS Code, o en View > Command Palette y ejecute
Python: Select Interpreter. Si su instalación de Python no aparece, seleccione Enter interpreter path y navegue hasta su ejecutable de Python. -
El entorno virtual no se activa: VS Code debería activarlo automáticamente al abrir una terminal. Si no, active manualmente: Windows:
.venv\Scripts\activate, Mac/Linux:source .venv/bin/activate. Verifique viendo(.venv)en el prompt de su terminal. -
IntelliSense no funciona: Asegúrese de que Pylance esté instalado y habilitado. Verifique que la esquina inferior derecha muestre su intérprete seleccionado. Espere 10-20 segundos después de abrir un archivo para que Pylance se inicialice. Reinicie VS Code si persisten los problemas.
-
pip install falla: Asegúrese de que su entorno virtual esté activado (busque
(.venv)en la terminal). En Linux, podría necesitar instalarpython3-venvprimero. En Windows, verifique que el antivirus no bloquee pip. -
SSL: CERTIFICATE_VERIFY_FAILEDen Mac: Abra Finder > Applications > Python 3.x y haga doble clic en Install Certificates.command; luego vuelva a ejecutar el script. -
La aplicación Streamlit no se ejecuta: Verifique que streamlit esté instalado en su entorno virtual (
pip show streamlit). Revise la terminal para mensajes de error. Asegúrese de que ninguna otra aplicación use el puerto 8501.
Resumen del Flujo de Trabajo
VS Code proporciona un entorno moderno y ligero para el desarrollo en Python con estas ventajas:
- Entorno unificado: Programe en Python, R, JavaScript y más en un solo editor
- IntelliSense potente: Autocompletados inteligentes, verificación de tipos e importaciones automáticas vía Pylance
- Depuración integrada: Establezca puntos de interrupción, inspeccione variables y avance paso a paso por el código
- Soporte Jupyter: Ejecute notebooks directamente en VS Code sin aplicaciones separadas
- Control de versiones: Integración Git incorporada para seguimiento de cambios
- Ecosistema de extensiones: Miles de extensiones para pruebas, formateo, linting y más
Creado por Steven Ge el 7 de diciembre de 2025.