Crea tu primer archivo de Python

En este apartado te voy a enseñar a crear tu primer archivo de Python y a seleccionar el intérprete que instalamos en un apartado anterior (al instalar Python en el PC).

Crear un archivo .py

Los archivos de código fuente de Python tienen que tener la extensión .py. Son archivos de texto plano que podemos escribir hasta con un bloc de notas. Por supuesto, no vamos a hacerlo con eso, ya que no contaríamos con todas las ayudas del entorno que hemos preparado en este módulo.

Ves a la parte del Explorador de Visual Studio Code. A continuación, haz clic en el icono "Nuevo archivo...". Este aparece solo si te diriges al lado del nombre de la carpeta de proyecto, como puedes ver en la imagen.

El atajo de teclado para abrir el panel del explorador es:
CTRL + SHIFT + E

Dale el nombre que quieras sin poner caracteres especiales (solo utiliza "_" o "-"), sin acentos, sin espacios en blanco e importante, que tenga finalmente la extensión .py. Verás que al escribirla, Visual Studio Code la reconoce y cambia el icono del archivo por el logo de Python. Esto indica que has puesto la extensión correcta.

Listo, a la derecha del explorador, verás un 1. Es aquí donde ya puedes empezar a escribir código Python.

Hello world en Python

Vamos a escribir una cosa muy sencilla. Una función print() para que puedas ejecutar tu primer programa con un mensaje en la consola.

La función print() sirve para "imprimir" o mostrar texto como una frase en la consola.

Escribe esto en la primera línea y cambia el contenido de la frase a tu gusto. Solo tienes que respetar las comillas " ". Estas son necesarias para que el intérprete de Python lea bien el texto. No las quites.

print("Hello, PCMaster!")

Normalmente, el primer mensaje que se imprime en la consola al aprender un nuevo lenguaje de programación es "Hello, world!". Sin embargo, no me gusta seguir esta costumbre, por eso, te invito a que imprimas lo que quieras.

En color azul, aparece la parte para cerrar la pestaña. En Visual Studio Code puedes abrir varios archivos a la vez. Estos se van apilando en esta zona como pestañas. Es lo mismo que las páginas abiertas en el navegador web.

Si en la zona de cierre de la pestaña tienes un punto como el que ves en la imagen, en lugar de una cruz, significa que tienes cambios sin guardar. Al ejecutar el archivo, Visual Studio Code lo guardará por tí, pero si trabajas mucho rato sin ejecutar tu código, es recomendable ir guardando de vez en cuando. Para guardar, puedes ir al menú superior > Archivo > Guardar o pulsar el atajo CTRL + S .

En la zona marcada en verde, hay un botón en forma de "Play" que sirve para ejecutar el código del archivo.

Seleccionar intérprete Python en VSCode

Pero antes de ejecutarlo, debemos tener seleccionado el intérprete de Python que instalamos anteriormente. Para hacer esto, solo tienes que ir a la parte naranja/amarilla de abajo y hacer clic en "Seleccionar intérprete".

No obstante, si ya te salía esto en la parte inferior de VSCode, en lugar de "Seleccionar intérprete", no hace falta que hagas este último paso. Ya lo tienes listo para ejecutar.

Path mal configurado

También, puede ser que tengas algo mal configurado (si has hecho una instalación limpia y seguido mis indicaciones, no deberías) y que no te salga ninguna opción de intérprete. Primero, asegúrate de que tienes Python instalado. Luego, mira que en las variables de entorno tengas el path configurado como mostré anteriormente (si crees que es muy complicado y no sabes hacerlo, déjame un comentario). Si ves que lo tienes todo bien y nada funciona, prueba de poner la ruta de Python manualmente. Haz click en "Seleccionar intérprete" y luego, en "Escriba la ruta de acceso del intérprete...":

Te saldrá esto. Dale a buscar para buscar la carpeta de instalación en el sistema o escríbela manualmente si la sabes. La ruta es hacia la carpeta que tiene el ejecutable python.exe.

Aquí he puesto la ruta por defecto en la instalación. Si no lo has cambiado y lo instalaste en la unidad C:, esta debería ser:

Independientemente de lo que te diga Visual Studio Code (puede decir que no es correcto el intérprete), cierra y vuelve a abrir el programa. Ahora ya, debería haber desaparecido "Seleccionar intérprete" y debería aparecer algo como esto:

Ya está todo listo para ejecutar el programa y ver nuestra frase en la consola. Haz clic en el botón para ejecutar (el que tiene forma de "play").

Te saldrá mucha cosa, pero lo importante, es que aparezca tu mensaje y no salga ningún error.

Quizás, te hayas percatado de que hay una pestaña que pone "Problemas". No le hagas caso de momento. Son solo recomendaciones y alertas de Pylint (extensión que hemos instalado anteriormente) de cosas que podrías hacer con mejores prácticas según las convenciones de Python.

Cambiar PowerShell por CMD

El código que hemos ejecutado, se ha realizado por defecto con PowerShell, que es la consola de Windows más moderna. Con ella, se ejecuta el intérprete de Python configurado y este interpreta el código. No obstante, para quien empieza en programación, suele ser más complicado utilizar PowerShell, ya que tiene muchas más cosas que no tiene CMD (la antigua consola de Windows).

Con el fin de que todos podáis aprender más cómodamente, vamos a cambiar la consola que utiliza Visual Studio Code.

Usa el atajo para abrir la paleta de comandos CTRL + SHIFT + P .

En ella, escribe "Terminal: Select Default Profile":

Elige CMD:

Cierra la anterior consola con el símbolo de la papelera:

Ahora, ejecuta el programa Python de nuevo. Visual Studio Code ya utilizará esta consola en lugar de la otra.

Configurar una tecla para ejecutar archivos de Python en VSCode

Para completar un poco más este capítulo, vamos a ver como configurar una tecla para ejecutar los archivos de Python (u otros lenguajes de programación).

Abre la paleta de comandos de nuevo. En ella, busca "Preferences: Open Keyboard Shortcuts".

Aquí, busca "Run Python File" y abre esta opción con doble clic:

Te saldrá esto. Aquí debes presionar la tecla o teclas que quieras para realizar dicha acción. Si te fijas, yo he elegido "F5" y está en uso para otras acciones. Aquí tienes que ir probando si tu atajo interfiere o no con otras acciones. Si es así, cámbialo.

Una vez configurada, pulsa la tecla ENTER y tu atajo quedará guardado:

Para probarlo, ves a tu archivo .py y presiona la tecla o teclas configuradas. Si se ejecuta solo al pulsarlas, lo has hecho perfecto.