Cómo crear un proyecto de Python con VS Code

Editado 2 hace días por ExtremeHow Equipo Editorial

PythonVisual Studio CodeVS CodeIDEConfiguración de ProyectoWindowsMacLinuxHerramientas de ProgramaciónDesarrollo

Crear un proyecto de Python usando Visual Studio Code (VS Code) es un proceso sencillo que puede beneficiar tanto a principiantes como a programadores experimentados. VS Code es un editor de código versátil y liviano desarrollado por Microsoft que admite varios lenguajes de programación, especialmente Python. Ofrece características como depuración, ejecución de tareas, control de versiones y un extenso mercado de extensiones para mejorar tu experiencia de codificación. Esta guía paso a paso te ayudará a configurar un proyecto de Python desde cero usando VS Code.

Requisitos

Antes de comenzar, asegúrate de tener los siguientes requisitos previos instalados en tu computadora:

• Entorno de ejecución de Python: Necesitas descargar e instalar Python desde el sitio web oficial de Python. Asegúrate de que la opción de instalación para agregar Python a la variable PATH de tu sistema esté habilitada.
• VS Code: Disponible en el sitio web oficial de Visual Studio Code, VS Code es un editor de código de fuente libre.
• Extensión de Python para VS Code: Esta extensión proporciona todo el soporte necesario para codificar en Python, como Intellisense (autocompletado de código), linting y depuración. Se puede instalar fácilmente desde el mercado de extensiones de VS Code.

Instalación de VS Code

Para comenzar, descarga el instalador de VS Code para tu sistema operativo desde el sitio web oficial. Sigue las instrucciones de instalación proporcionadas, asegurándote de que todos los componentes requeridos, especialmente los relacionados con el desarrollo, estén seleccionados. Una vez instalado, inicia VS Code.

Configuración del entorno de Python

Instalación de Python

Para instalar Python, visita el sitio web oficial de Python y descarga el instalador para tu sistema operativo. Ejecuta el instalador y elige las opciones de configuración que mejor se adapten a ti, asegurándote de agregar Python al sistema PATH si te lo solicita.

Instalación de Extensiones de Python en VS Code

Inicia VS Code y abre la vista de Extensiones haciendo clic en el ícono de extensiones en la Barra de Actividades en el lado de la ventana o usando el atajo Ctrl+Shift+X. Busca "Python" en el mercado de extensiones. Haz clic en Instalar para agregar la extensión de Python de Microsoft. Esta extensión añade funciones esenciales específicas de Python al editor, las cuales son necesarias para desarrollar aplicaciones en Python.

Creación de un nuevo proyecto de Python

Después de configurar Python y las extensiones requeridas, el siguiente paso es crear un nuevo proyecto de Python. Puedes hacerlo usando VS Code con el siguiente método:

Abrir un nuevo espacio de trabajo

Un espacio de trabajo en VS Code es un contenedor en el cual puedes administrar los archivos de tu proyecto de Python. Para comenzar, abre VS Code y selecciona “Abrir Carpeta” en el menú Archivo. Crea una nueva carpeta en tu directorio deseado donde quieras almacenar los archivos de tu proyecto de Python. Una vez creada la carpeta, selecciónala y ábrela en VS Code.

Creación de un archivo Python

Dentro de tu carpeta de proyecto, crea un nuevo archivo Python. Puedes hacerlo haciendo clic en el ícono "Nuevo Archivo" en la vista del Explorador (la barra lateral izquierda con las carpetas/archivos) o usando el menú Archivo y seleccionando "Nuevo Archivo". Nómbralo de manera descriptiva, como main.py. Este será tu archivo de script Python principal donde escribirás tu código.

Escribir código Python

Python es un lenguaje interpretado, por lo que puedes escribir y ejecutar tu código inmediatamente después de crear tu archivo Python.

Escribir un programa simple

Para comenzar, vamos a crear un programa simple que imprima "¡Hola, Mundo!" en la consola. Esto se puede hacer escribiendo el siguiente código en tu archivo main.py:

print("¡Hola, Mundo!")

Ejecutar tu código Python

Para ejecutar tu script de Python, tienes varias opciones. La manera más fácil es abrir el terminal directamente en VS Code. Puedes abrir el terminal seleccionando "Terminal" en el menú superior y luego "Nuevo Terminal". En el terminal, asegúrate de estar en el directorio correcto que contiene tu archivo main.py y ejecuta el script escribiendo el comando:

python main.py

Si todo está configurado correctamente, su salida debería ser así:

¡Hola, Mundo!

Usar el Depurador de VS Code

Una de las características poderosas de VS Code es su depurador integrado, que se puede usar para identificar y corregir problemas en tu código. Para usar el depurador, establece un punto de interrupción en tu archivo de script haciendo clic en el margen a la izquierda de los números de línea. Esto creará un pequeño punto rojo que indica dónde se detendrá la ejecución de tu script.

Configurar el depurador

Para comenzar a depurar, ve al ícono de Depuración en la barra de Actividades y haz clic en el ícono de engranaje para abrir el archivo de configuración launch.json. VS Code sugerirá una configuración predeterminada para proyectos de Python, que puedes ajustar según sea necesario.

Ejemplo de configuración launch.json:

{ "version": "0.2.0", "configurations": [ { "name": "Python: Archivo Actual", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal" } ] }

Iniciar una sesión de depuración

Después de establecer puntos de interrupción y verificar la configuración del depurador, inicia el depurador presionando F5 o haciendo clic en la opción "Iniciar Depuración" en el menú de Depuración. Tu script de Python se ejecutará y detendrá su ejecución en el punto de interrupción, permitiéndote inspeccionar variables, recorrer el código e identificar cualquier problema.

Gestión de dependencias del proyecto Python

Gestionar dependencias es crucial para cualquier proyecto de Python, y puede manejarse eficientemente usando entornos virtuales.

Creación de entornos virtuales

En tu carpeta de proyecto, crea un entorno virtual ejecutando el siguiente comando en el terminal:

python -m venv venv

Este comando creará un nuevo directorio llamado venv que contendrá una instalación independiente de Python junto con otros scripts y ejecutables. Es una buena práctica organizar tus dependencias separadamente de los paquetes globales instalados en tu sistema.

Activación del entorno virtual

Para activar el entorno virtual, ejecuta:

• para Windows:

  .\venv\Scripts\activate

• Para MacOS/Linux:

  source venv/bin/activate

Una vez activado, el indicador del terminal debería reflejar el entorno activo, usualmente anteponiendo el comando con (venv).

Instalación de paquetes usando pip

Cuando el entorno virtual está activado, puedes instalar paquetes usando pip. Por ejemplo, si tu proyecto requiere el paquete numpy, instálalo con el comando:

pip install numpy

Para congelar las dependencias actuales del entorno en un archivo requirements.txt que puedes enviar a tu repositorio de control de versiones, usa:

pip freeze > requirements.txt

Más tarde, cualquiera con acceso a tu proyecto puede instalar las dependencias ejecutando pip install -r requirements.txt.

Uso del control de versiones con Git

Git es una herramienta esencial para gestionar versiones de código y colaborar con otros. VS Code tiene soporte integrado de Git que facilita el seguimiento de cambios y la colaboración en proyectos.

Inicialización del Repositorio Git

Para inicializar un repositorio Git en tu carpeta de proyecto, abre el terminal en VS Code y escribe:

git init

Este comando crea un nuevo repositorio Git en tu directorio de proyecto. Tu carpeta de proyecto ahora contiene un directorio .git, que está oculto por defecto.

Realizando tu primer commit

Después de inicializar el repositorio, realiza tu primer commit al añadir cualquier cambio y cometerlos. Usa estos comandos:

git add . 
git commit -m "Initial commit"

El primer comando prepara todos los archivos, y el segundo realiza el commit con el mensaje "Initial commit".

Uso de la vista de Control de Fuente

VS Code proporciona una interfaz intuitiva para operaciones de Git. Haz clic en el ícono de Control de Fuente en la Barra de Actividades para ver una lista de cambios, preparar cambios y realizar commits usando la interfaz de VS Code.

Resumen

Visual Studio Code proporciona un entorno de desarrollo altamente integrado que soporta todo el ciclo de vida de un proyecto de Python, desde escribir y ejecutar código hasta depurar, gestionar dependencias y control de versiones.

Esta guía cubre la instalación de VS Code, la configuración de Python, la creación de un espacio de trabajo de proyecto, la escritura y ejecución de código, el uso de herramientas de depuración, la gestión de dependencias con entornos virtuales y la integración del control de versiones con Git. Al aprovechar eficazmente estas herramientas, puedes agilizar el proceso de desarrollo, prueba y despliegue de aplicaciones Python, aumentando tanto la productividad individual como la colaborativa en la codificación.

  Comparte este artículo

Si encuentras algo incorrecto en el contenido del artículo, puedes solicitar una actualización