Primer proyecto

8.1 Desglose de la interfaz de la IDE

Entonces, hemos creado un nuevo proyecto. Vamos a ver qué encontramos aquí.

1. Árbol de carpetas y archivos del proyecto:

Aquí se muestra el contenido de la carpeta de nuestro proyecto — pythonProject.

2. Archivo abierto actual:

Este es simplemente el contenido del archivo main.py, con la sintaxis del código resaltada.

3. En la parte superior — el menú principal:

Botones útiles en la parte superior derecha:

• «Triángulo verde» — botón para ejecutar el proyecto.
• «Bicho» — botón para iniciar el modo de depuración.
• «Lupa» — buscar en el proyecto.
• «Engranaje» — configuraciones.

4. A la izquierda ves el menú lateral:

Aquí hay varios botones útiles, en particular, nos interesará el botón Terminal.

5. Barra de estado:

A la izquierda en la barra de estado se muestra la ruta del archivo abierto actual. A la derecha — su codificación: CRLF, UTF-8.

Y completamente a la derecha se muestra la versión actual de Python — Python 3.12.x, en la que nuestro proyecto se ejecutará. A veces es útil mirar aquí, si en tu computadora tienes instaladas varias versiones diferentes de Python y hay proyectos que funcionan en otras versiones.

8.2 Análisis del proyecto

Un proyecto normal consta de archivos que se muestran en el panel izquierdo. Estos archivos se pueden dividir condicionalmente en 4 partes.

Archivos con código en lenguaje Python. Tales archivos tienen la extensión .py y PyCharm los marca con un icono azul y amarillo. En nuestro proyecto ahora solo hay un archivo de este tipo — main.py

Archivos estáticos. Así se llaman los archivos que contienen datos, pero no código. Pueden ser archivos de texto, imágenes, archivos multimedia, etc. Ahora no los hay en nuestro proyecto.

Entorno virtual de Python. En la carpeta con el nombre .venv (abreviatura de Virtual Environment) se encuentran los archivos de Python, así como varias utilidades de servicio. Aquí mismo el gestor de paquetes pip cargará bibliotecas de terceros que desees utilizar.

Bibliotecas de terceros (External libraries). Ahora no las hay en nuestro proyecto, pero cuando las descargues, PyCharm seguramente las mostrará aquí.

8.3 Entorno virtual .venv

Hablemos un poco más detalladamente sobre el entorno virtual. .venv es un módulo en Python que brinda la posibilidad de crear diferentes entornos virtuales ligeros y aislados para proyectos de Python. Es una herramienta que permite gestionar las dependencias del proyecto, aislándolas de las bibliotecas del sistema. Imagina que es una habitación aislada para tu proyecto, donde puede guardar sus juguetes y herramientas personales sin molestar al resto de los habitantes de la casa.

Técnicamente esto funciona de manera simple: dentro de la carpeta del proyecto se crea una copia del intérprete de Python y un lugar separado para las bibliotecas. Esto garantiza que si instalas alguna versión específica de una biblioteca para un proyecto, no romperá otro que necesite una versión más antigua. El uso de un entorno virtual es una regla de buen tono que salva de conflictos de versiones interminables.

Gestión del entorno en PyCharm

PyCharm generalmente se encarga de esto y crea todo automáticamente. Pero sucede que accidentalmente eliminaste la carpeta necesaria o simplemente quieres comenzar todo desde cero. Saber gestionar estas configuraciones manualmente es una habilidad útil.

Creamos un entorno

En la esquina inferior derecha se muestra el estado de la conexión del lenguaje Python. Si ves allí una inscripción como Python 3.XX, significa que la instalación fue exitosa. El entorno de desarrollo ve el intérprete y está listo para ejecutar tus comandos.

Si allí dice No interpreter, haz clic en esa inscripción.

1. En el menú que aparece, seleccionamos Add New Interpreter y luego Add Local Interpreter.
2. En la configuración de la izquierda seleccionamos Environment. En el centro asegúrate de que esté marcada la casilla en Generate New.
3. Pulsamos OK. El editor creará una nueva carpeta .venv e inmediatamente cambiará el proyecto a ella. Ahora tienes un sistema absolutamente limpio sin basura innecesaria.

Eliminamos lo viejo o innecesario

A veces los experimentos llegan a un callejón sin salida, y es más fácil eliminar el entorno que intentar arreglarlo. Así es como se hace:

1. Nuevamente hacemos clic en la versión de Python en la esquina inferior derecha y seleccionamos el punto Interpreter Settings.
2. Arriba buscamos el campo Python Interpreter. Desplegamos la lista y seleccionamos el punto Show All.
3. Verás una lista de todos los entornos que PyCharm conoce. Selecciona el que deseas eliminar y presiona el botón con el menos en el menú sobre la lista.
4. Un punto importante: PyCharm simplemente «olvidará» este entorno y dejará de usarlo. Para liberar físicamente espacio en el disco, debes ir a la carpeta del proyecto a través del explorador habitual y eliminar la carpeta .venv manualmente.

Creación de un segundo entorno

Error: «Already contains Python»

Si entras en el menú de agregar intérprete y seleccionas Generate new, PyCharm puede mostrar una advertencia roja y bloquear el botón OK. Esto sucede porque el editor, por costumbre, intenta crear un nuevo entorno en la misma carpeta .venv que ya está ocupada por tu primer entorno. Dos conjuntos diferentes de bibliotecas no pueden vivir en una sola carpeta.

Cómo arreglar esto

Simplemente hay que darle al nuevo «arenero» un nombre único. Así es como se hace:

1. Abre el menú Add Local Interpreter, como hicimos antes.
2. Selecciona el punto Generate new.
3. Mira el campo Location. Lo más probable es que la ruta allí termine en el nombre estándar \.venv.
4. Pon el cursor al final de la línea y simplemente añade cualquier dígito allí. Cambia el final de la ruta a \.venv_2 y presiona Enter.
5. La inscripción roja desaparecerá inmediatamente. Presiona OK.

Ahora en tu proyecto existirán físicamente dos carpetas diferentes con configuraciones, y PyCharm cambiará automáticamente a la nueva versión.

Cómo cambiar entre entornos

La habilidad de hacer malabarismos con los entornos es una habilidad importante. Pero aquí hay una trampa: PyCharm no siempre recuerda tus entornos antiguos automáticamente.

A menudo sucede que creaste un segundo entorno, y el primero desapareció del menú, aunque la carpeta .venv todavía está en el proyecto. En este caso, simplemente debes indicar a PyCharm dónde buscar el Python antiguo. Ejemplo para cambiar de .venv_2 a .venv:

1. Haz clic en la versión de Python en la esquina y selecciona Add New Interpreter -> Add Local Interpreter.
2. En la ventana que aparece, cambia el punto a Select Existing.
3. En el campo Python Path haz clic en el icono de la carpeta a la derecha.
4. Ahora necesitas encontrar el archivo de inicio de Python en tu antigua carpeta (.venv). Sigue la ruta: Tu_proyecto -> .venv -> Scripts (para Windows) o bin (para macOS/Linux).
5. Dentro de esta carpeta selecciona el archivo python y presiona OK.

Ahora el entorno antiguo aparecerá nuevamente en la configuración y se volverá activo. Este método funciona sin fallos, incluso si PyCharm «olvidó» tus configuraciones.

8.4 Trabajando con el terminal

En PyCharm puedes trabajar con la línea de comandos del sistema operativo directamente. En Linux y MacOS, la línea de comandos se suele llamar Terminal, por lo que también se llama así en PyCharm. Aunque en principio no es un capricho de PyCharm, sino un nombre establecido entre los programadores.

Para abrir el Terminal necesitas hacer clic en el botón de terminal en el menú lateral:

Deberías ver una ventana como esta:

En esta ventana puedes escribir comandos de tu sistema operativo. Nos interesa uno de ellos.

Averiguemos la versión actual del intérprete de Python que instalamos. Para ello, debes escribir:

        python --version

Esto es lo que obtuve:

Si también obtuviste Python 3.12.x, entonces estamos en el camino correcto.