Visual Studio Code

Verificación previa

Antes de instalar Visual Studio Code, conviene comprobar que Python ya se encuentra instalado en tu equipo y que puede ejecutarse desde la terminal.

Programar no depende solo del lenguaje. También requiere un espacio de trabajo que permita escribir código con comodidad, organizar archivos, ejecutar programas y detectar errores con mayor facilidad. En este curso utilizaremos Visual Studio Code, un editor que ofrece justamente ese entorno de trabajo inicial.

Objetivo

Instalar Visual Studio Code, preparar una carpeta de trabajo inicial y configurar los elementos básicos necesarios para comenzar a programar en Python.

Qué es Visual Studio Code

Visual Studio Code, también conocido como VS Code, es un editor de código multiplataforma. Su función principal no es ejecutar Python por sí mismo, sino ofrecer un entorno más adecuado para escribir, revisar y organizar programas.

Trabajar con un editor como este permite:

• Escribir código con mayor claridad
• Organizar archivos y carpetas del proyecto
• Instalar extensiones para trabajar con Python
• Usar una terminal sin salir del editor
• Detectar errores con mayor facilidad

Importante

Visual Studio Code no reemplaza a Python. El editor sirve para escribir y organizar código, mientras que Python es el intérprete que lo ejecuta.

Qué prepararemos aquí

En esta guía se realizará una configuración inicial orientada al trabajo del curso. Eso incluye:

• Instalar Visual Studio Code
• Reconocer las partes principales de su interfaz
• Instalar la extensión de Python
• Abrir una carpeta de trabajo
• Crear un primer archivo .py
• Ejecutarlo desde la terminal integrada

La meta no es explorar todas las funciones del editor, sino dejarlo listo para comenzar a programar con una base ordenada.

Instalación y configuración

1. Descargar Visual Studio Code

   Ingresa al sitio oficial de descarga de Visual Studio Code y selecciona la versión correspondiente a tu sistema operativo.

   [IMAGEN: Página oficial de descarga de Visual Studio Code]

2. Instalar Visual Studio Code

   Ejecuta el instalador descargado y sigue el asistente correspondiente a tu sistema.

   En la mayoría de los casos, la instalación por defecto es suficiente para comenzar a trabajar. Lo importante es completar correctamente el proceso y poder abrir el editor sin problemas.

3. Abrir VS Code por primera vez

   Una vez terminada la instalación, abre Visual Studio Code. Al iniciar, encontrarás varias zonas principales de la interfaz.

   Elemento	Función general
   Explorador	Muestra archivos y carpetas del proyecto.
   Editor	Permite escribir y modificar el contenido de los archivos.
   Barra lateral	Da acceso a secciones como archivos, búsqueda y extensiones.
   Terminal	Permite ejecutar comandos sin salir del editor.

   [IMAGEN: Interfaz principal de Visual Studio Code]

   Esta primera revisión es importante porque ayuda a entender que el editor no es solo un espacio para escribir texto: también organiza el trabajo, conecta con la terminal y facilita la navegación por los archivos del proyecto.

4. Instalar extensiones recomendadas

   Abre la sección Extensions en la barra lateral y revisa las siguientes extensiones.

   [IMAGEN: Vista de extensiones instaladas]

   Extensiones esenciales

   • Python: Extensión oficial para trabajar con Python en VS Code. Mejora el reconocimiento del lenguaje y facilita tareas como selección del intérprete, resaltado de sintaxis, depuración y navegación del código.
   • Spanish Language Pack for Visual Studio Code: Traduce la interfaz de Visual Studio Code al español. Puede ser útil si prefieres trabajar con los menús y configuraciones del editor en este idioma.

   Extensiones recomendadas

   • Material Icon Theme: Mejora la visualización de archivos y carpetas mediante íconos más claros y fáciles de identificar.
   • Error Lens: Hace más visibles los errores, advertencias y diagnósticos directamente en el editor.
   • Code Runner: Permite ejecutar archivos o fragmentos de código desde VS Code. Puede ser útil, pero en este curso seguiremos privilegiando la ejecución desde la terminal integrada.

   Recomendación

   Para este curso, la extensión más importante es Python. Las demás mejoran la experiencia de uso, la lectura visual del editor y la detección de errores, pero no son imprescindibles para comenzar.

5. Aplicar algunos ajustes iniciales

   Después de instalar las extensiones, conviene realizar algunos ajustes básicos para trabajar de forma más cómoda.

   Ajustes sugeridos

   • Desactivar Explorer: Compact Folders para visualizar las carpetas de forma separada
   • Ocultar la carpeta __pycache__ en el explorador
   • Activar Editor: Linked Editing si más adelante también trabajarás con archivos que usan etiquetas, como HTML

   Buena práctica

   Estos ajustes no cambian el funcionamiento de Python, pero sí mejoran la organización visual del entorno de trabajo.

   Configuración sugerida

   Si deseas aplicar estos ajustes manualmente desde settings.json, puedes usar una configuración como esta:

   {
     "explorer.compactFolders": false,
     "files.exclude": {
       "**/__pycache__": true
     },
     "editor.linkedEditing": true
   }

   [IMAGEN: Editor de configuración de VS Code mostrando los ajustes sugeridos]

6. Abrir una carpeta de trabajo

   En lugar de trabajar con archivos aislados, conviene abrir una carpeta que funcione como espacio de trabajo del proyecto.

   Para hacerlo:

   • Selecciona File > Open Folder
   • Crea o elige una carpeta para tus archivos del curso
   • Ábrela dentro de VS Code

   [IMAGEN: Opción “Open Folder” en Visual Studio Code]

   Buena práctica

   Trabajar desde una carpeta permite organizar mejor los archivos y facilita el uso de la terminal integrada.

7. Crear un archivo Python

   Dentro de la carpeta abierta, crea un nuevo archivo llamado hola.py.

   Luego escribe el siguiente contenido:

   print("¡Hola Python!")

   Guarda el archivo.

8. Verificar el intérprete de Python

   Con el archivo hola.py abierto, VS Code debería detectar el intérprete de Python instalado en el sistema o permitir seleccionarlo manualmente.

   Si es necesario, abre la paleta de comandos y busca la opción para seleccionar intérprete.

   [IMAGEN: Selección de intérprete de Python en VS Code]

   Este paso es importante porque el editor necesita saber qué instalación de Python utilizará para trabajar con los archivos del proyecto.

9. Abrir la terminal integrada y ejecutar el archivo

   Abre la terminal integrada desde el menú superior o con el atajo correspondiente a tu sistema.

   Una vez abierta, verifica que estás dentro de la carpeta de trabajo y ejecuta:

   python hola.py

   o, si tu sistema utiliza ese comando:

   python3 hola.py

   Si todo está correcto, deberías ver el mensaje en pantalla.

   [IMAGEN: Terminal integrada ejecutando hola.py]

Qué deberías haber conseguido

Al terminar esta configuración inicial, deberías contar con lo siguiente:

• Visual Studio Code instalado y funcionando
• La extensión de Python disponible en el editor
• Una carpeta de trabajo abierta
• Un archivo .py creado y guardado
• La capacidad de ejecutar ese archivo desde la terminal integrada

Eso significa que el editor ya quedó listo para comenzar a trabajar con los siguientes contenidos del curso.

Qué hacer si algo no funciona

Si VS Code abre correctamente, pero el archivo no se ejecuta como esperas, conviene revisar primero estos puntos:

• Si Python está instalado y puede ejecutarse desde la terminal
• Si la extensión de Python está instalada y habilitada
• Si el intérprete correcto fue seleccionado dentro del editor
• Si la terminal está ubicada en la carpeta donde guardaste el archivo

En muchos casos, el problema no está en el editor completo, sino en uno de estos pasos de conexión entre archivo, intérprete y terminal.

Error frecuente

Un error frecuente es pensar que instalar VS Code basta para programar en Python. Para trabajar correctamente también necesitas tener Python instalado y la extensión de Python habilitada dentro del editor.