Visual Studio Code. Configuración recomendada para el curso Introducción a la programación con Python

Esta es la configuración de Visual Studio Code que se recomienda para seguir este curso.

Esta lección no detalla los pasos para configurar Visual Studio Code. En caso necesario, puede consultar la lección Personalización de VSC de los apuntes de Informática general, en la que se explica detalladamente cómo se personaliza Visual Studio Code. En dichos apuntes también puede consultar lecciones dedicadas a Visual Studio Code, como Presentación general, Instalación, Uso y otras, que le pueden ser de ayuda si no conoce Visual Studio Code.

Tema de color recomendado para el curso de Python

El tema de color es un aspecto muy personal por lo que se deja a elección del alumno el tema de color empleado.

En las capturas de los apuntes se empleará el Tema Dark+ (default dark).

VSC. Tema Light+ predeterminado

Área de trabajo

Esta es el área de trabajo recomendada para seguir este curso.

  1. Cree la carpeta Documentos > LMSGI > Python:

    VSC. Área de trabajo

  2. Cree las carpeta Documentos > LMSGI > Python > ejercicios y Documentos > LMSGI > Python > pruebas:

    VSC. Área de trabajo

  3. Elija la opción de menú Archivo > Abrir carpeta ...:

    VSC. Área de trabajo

  4. Elija la carpeta Documentos > LMSGI > Python:

    VSC. Área de trabajo

  5. Se abrirá en Explorador en la barra de actividades para ver el contenido de la carpeta elegida:

    VSC. Área de trabajo

Preferencias de configuración recomendadas para el curso de Python

Estas son las preferencias de configuración que se aconseja establecer para seguir este curso.

Las preferencias propuestas relacionadas con extensiones requieren la instalación de las extensiones correspondientes.

Preferencias globales (Usuario)

Extensiones recomendadas para el curso de Python

Estas son las dos extensiones que se aconseja instalar para seguir este curso.

multi-command

Autor: ryuta46

Marketplace: multi-command

Repositorio GitHub: multi-command


Esta extensión permite crear comandos que ejecuten a su vez varios comandos de Visual Studio Code.

Python extension for Visual Studio Code

Logotipo de Python for VSC

Autor: Microsoft (Don Jayamanne)

Marketplace: Python

Repositorio GitHub: Python


Don Jayamanne, el creador de la extensión Python trabaja en Microsoft desde noviembre de 2017. Desde entonces, la extensión se publica como extensión oficial por parte de Microsoft y además se publica regularmente todos los meses.

En el Blog de Python en Microsoft se anuncian las novedades mensuales en la extensión Python:


Al instalar la extensión Python en Visual Studio Code, se debe instalar el módulo pylint y es conveniente instalar un módulo de autoformato.

Instalación de pylint

Al guardar por primera vez un programa de Python, Visual Studio Code mostrará un aviso indicando que pylint no está instalado y que le ofrecerá la opción de instalarlo automáticamente.

  1. Abra o escriba un programa cualquiera y guárdelo.
  2. Se mostrará el aviso indicando que pylint no está instalado. Haga clic en "Install" para instalarlo.

    VSC. Instalación de pylint

  3. Se abrirá en la parte inferior una ventana de terminal en la que se ejecutará la instalación de pylint y de sus dependencias. Si la instalación se realiza correctamente, se mostrará el aviso correspondiente. Puede cerrar la ventana haciendo clic en el icono de cierre.

    VSC. Instalación de pylint

    Nota: Como puede verse en la captura, se muestra un aviso en color amarillo indicando que los paquetes se han instalado en una carpeta que no está en la variable de entorno de Windows PATH. Eso se debe a que VSCode instala los paquetes con la opción --user, por lo que los paquetes se instalan en la carpeta ..\AppData\Roaming\Programs\Python\..., mientras que Python está instalado en ..\AppData\Local\Programs\Python\... En principio no es necesario añadir ninguna carpeta al PATH de Windows.


Configuración de pylint

La configuración inicial de Pylint en VSCode es una configuración mínima (documentación de VSCode) que por el momento no modificaremos.

La lista de mensajes de error y avisos de Pylint se encuentra en el apartado Pylint Features de la documentación de Pylint. En Wikidot hay también una lista ordenada por código de error, pero no sé si está actualizada.

Instalación de módulo de autoformato

Al formatear código por primera vez después de instalar la extensión Python, Visual Studio Code mostrará un aviso indicando que no hay ningún formateador de código de Python instalado y que le ofrecerá la opción de instalar algún módulo de autoformato. Actualmente (enero de 2020), los módulos de autoformato que ofrece son:

  1. Abra o escriba un programa cualquiera y teclee el atajo Shift+Alt+f para formatear el código.
  2. Se mostrará el aviso indicando que no hay ningún formateador instalado.

    VSC. Instalación de black

  3. Haga clic en "Use black" para instalarlo.

    VSC. Instalación de black

    Nota: En estos apuntes se recomienda el módulo black, pero se podría utilizar otro módulo. El formato aplicado no afecta al resultado ni a la velocidad de ejecución de los programas.

  4. Se abrirá en la parte inferior una ventana de terminal en la que se ejecutará la instalación de black y de sus dependencias. Si la instalación se realiza correctamente, se mostrará el aviso correspondiente. Puede cerrar la ventana haciendo clic en el icono de cierre.

    VSC. Instalación de black

    Nota: Como puede verse en la captura, se muestra un aviso en color amarillo indicando que los paquetes se han instalado en una carpeta que no está en la variable de entorno de Windows PATH. Eso se debe a que VSCode instala los paquetes con la opción --user, por lo que los paquetes se instalan en la carpeta ..\AppData\Roaming\Programs\Python\..., mientras que Python está instalado en ..\AppData\Local\Programs\Python\... En principio no es necesario añadir ninguna carpeta al PATH de Windows.

  5. Se creará una carpeta .vscode con el archivo de configuración del área de trabajo settings.json. Este archivo contiene la preferencia de configuración que indica a Visual Studio Code que queremos utilizar el formateador black.

    VSC. Instalación de black

Tareas recomendadas para el curso de Python

No es necesario añadir ninguna tarea específica.

Atajos de teclado recomendados para el curso de Python

Estos son los atajos de teclado que se aconseja añadir para seguir este curso.

Mover foco del editor al terminal y viceversa

Los dos atajos (Ctrl+Alt++ y Ctrl+Alt+-) permiten pasar el foco de la ventana de edición a la ventana del terminal y viceversa.

Ejecutar programa

Los dos atajos (Ctrl+Alt+F5 y Ctrl+Alt+Shift+F5) permiten ejecutar el programa de Python que se esté editando. El programa se ejecuta en la ventana de terminal PowerShell de Visual Studio Code. Se ha elegido la tecla F5 ya que esta es la tecla que permite ejecutar programas en IDLE.

La diferencia entre ambos atajos es que:

VSC. Ejecutar programas Python en VSC


Si no se define el atajo de teclado, el programa se puede ejecutar igualmente haciendo clic derecho en el cuerpo del programa y eligiendo la opción "Ejecutar archivo Python en la terminal".

VSC. Ejecutar programas Python en VSC