2.2.-Modulos
2.2. Gestión de módulos, plugins y extensiones¶
Idea principal
Un entorno de desarrollo puede crecer junto con el proyecto mediante extensiones, plugins y módulos. La decisión profesional no consiste en instalar muchos complementos, sino en elegir los necesarios, configurarlos con herramientas coherentes y mantenerlos actualizados y reproducibles.
Cuando trabajamos con un entorno de desarrollo integrado (IDE) necesitamos algo más que un editor de texto: podemos necesitar soporte para un lenguaje, depuración, pruebas, análisis estático, formateo, conexión con una base de datos o integración con un framework. Los IDE y los editores extensibles ofrecen estas funciones mediante complementos que se añaden a la instalación o al proyecto.
En este tema aprenderás a distinguir los términos, instalar complementos en Visual Studio Code y en productos de JetBrains, integrar Pylint y autopep8 en PyCharm y gestionar el ciclo de vida de lo instalado. Las rutas y los nombres exactos de algunos menús pueden cambiar entre versiones; por eso se incluyen enlaces a la documentación oficial y se explica el propósito de cada configuración.
Este apartado trabaja principalmente el CE 2.b. La automatización mediante File Watchers y herramientas externas sirve también como aplicación concreta del CE 2.c, aunque no sustituye el desarrollo completo de ese criterio en el apartado dedicado a la personalización.
| Código | Descripción |
|---|---|
| RA 2 | Evalúa entornos integrados de desarrollo analizando sus características para editar código fuente y generar ejecutables. |
| CE 2.b | Se han añadido y eliminado módulos en el entorno de desarrollo. |
Qué deberías saber al terminar
Al acabar este tema deberías poder:
- diferenciar una extensión de Visual Studio Code, un plugin de JetBrains y un módulo de proyecto;
- instalar y desinstalar complementos desde sus gestores oficiales;
- configurar un linter y un formateador para que utilicen el intérprete del proyecto;
- automatizar la ejecución de herramientas mediante herramientas externas y File Watchers;
- revisar la procedencia, los permisos, la compatibilidad y el mantenimiento de un complemento antes de incorporarlo al entorno.
Mapa del tema
En este documento vamos a seguir esta secuencia:
- aclarar qué significa cada tipo de complemento;
- instalar y configurar extensiones en Visual Studio Code;
- gestionar módulos y plugins en IntelliJ IDEA y PyCharm;
- integrar Pylint y autopep8 mediante herramientas externas y File Watchers;
- mantener el entorno, evitar riesgos y documentar la configuración.
1. Qué son los módulos, plugins y extensiones¶
En el lenguaje cotidiano se suele llamar módulo, plugin, extensión o complemento a cualquier pieza que amplía un IDE. Sin embargo, no son siempre sinónimos. Conocer la diferencia evita configurar una cosa pensando que estamos configurando otra.
Complemento
Un complemento es un componente opcional que amplía las capacidades de una aplicación. Puede aportar soporte para un lenguaje, depuración, integración con un framework, análisis de código, formateo, conexión con servicios o cualquier otra función que no forme parte del núcleo.
La terminología depende del producto:
| Término | Dónde se usa habitualmente | Para qué sirve | Ejemplo |
|---|---|---|---|
| Extensión | Visual Studio Code | Añadir lenguajes, depuradores, linters, formateadores o comandos al editor | Extensión Python, Pylint o autopep8 |
| Plugin | Productos de JetBrains | Ampliar las funciones del IDE con soporte para lenguajes, frameworks o herramientas | Plugin de Kotest o de Docker |
| Módulo de proyecto | IntelliJ IDEA y otros IDE de JetBrains | Organizar una parte del proyecto, sus fuentes, dependencias, SDK y configuración | Un módulo para el servidor y otro para el cliente |
| Herramienta externa | PyCharm, IntelliJ IDEA y otros IDE | Ejecutar desde el IDE un programa instalado fuera de él | pylint o autopep8 instalado en un entorno virtual |
En Visual Studio Code hablaremos principalmente de extensiones. En JetBrains distinguiremos entre plugins, que añaden capacidades al IDE, y módulos de proyecto, que organizan el código y su configuración. Un módulo de proyecto no es automáticamente el plugin que proporciona soporte para un lenguaje.
Estas ampliaciones pueden aportar, entre otras, las siguientes funciones:
- soporte para nuevos lenguajes de programación;
- autocompletado, navegación y refactorización sensibles al lenguaje;
- depuración y ejecución de pruebas;
- integración con frameworks como React, Django o Spring;
- linters y formateadores de código;
- conexión con bases de datos, servidores o contenedores;
- herramientas para diseñar interfaces gráficas;
- integración con sistemas de control de versiones.
La extensibilidad permite instalar solo lo que el proyecto necesita, pero cada complemento puede consumir memoria, añadir configuraciones, introducir dependencias o ampliar la superficie de riesgo. Por tanto, «más extensiones» no equivale a «mejor entorno».
flowchart TD
A["Necesidad del proyecto"] --> B["Buscar complemento compatible"]
B --> C{"¿Procedencia y permisos son adecuados?"}
C -->|"No"| D["Descartar o buscar una alternativa"]
C -->|"Sí"| E["Instalar desde el gestor oficial"]
E --> F["Configurar intérprete, alcance y reglas"]
F --> G["Probar y documentar la configuración"]
G --> H["Revisar actualizaciones y necesidad real"]
El flujo anterior es aplicable tanto a una extensión de Visual Studio Code como a un plugin de JetBrains. La instalación es solo un paso: el entorno debe quedar comprobado y otra persona debería poder entender qué se ha añadido y por qué.
2. Instalación de extensiones en Visual Studio Code¶
Visual Studio Code es un editor ligero y extensible. Su instalación inicial incluye funciones generales, pero el soporte de una tecnología concreta puede requerir extensiones adicionales y herramientas externas, como un intérprete, un compilador o un depurador.
2.1. Acceso al Marketplace de extensiones¶
Para abrir el gestor de extensiones:
- Abre Visual Studio Code.
- Selecciona el icono de Extensiones de la barra de actividad o ejecuta el comando View: Extensions.
- Como alternativa, utiliza
Ctrl + Shift + Xen Windows y Linux. En macOS el atajo puede ser diferente según la configuración de teclado. - Escribe en el buscador el lenguaje, la herramienta o el identificador de la extensión que necesites.
La ficha de cada resultado permite comprobar el nombre del editor, el identificador, la descripción, las dependencias, las contribuciones, el registro de cambios y la documentación. No conviene seleccionar automáticamente el primer resultado: hay que verificar que sea el complemento adecuado y que siga siendo compatible con la versión del proyecto.
2.2. Instalación de una extensión¶
Imagina que vas a desarrollar una página web con HTML, CSS y JavaScript. El editor ya reconoce parte de la sintaxis, pero puedes añadir extensiones para frameworks, análisis, formateo, contenedores o control de calidad.
El procedimiento general es:
- Abre la vista Extensiones.
- Busca el nombre de la extensión.
- Comprueba el editor, el identificador, la compatibilidad y los permisos que solicita.
- Pulsa Install o Instalar.
- Lee la documentación de la extensión y configura sus opciones.
- Comprueba su funcionamiento en un archivo o proyecto de prueba.
En el caso de Python, la extensión Python de Microsoft aporta integración con el lenguaje, pero algunas funciones pueden depender de extensiones complementarias, como Pylance, un depurador o una extensión de pruebas. También es necesario tener instalado Python y seleccionar el intérprete correcto. Una extensión no instala automáticamente todo el ecosistema del lenguaje.
Ejemplo: preparar un proyecto web
Para un proyecto con HTML, CSS y JavaScript, puedes empezar con las capacidades incluidas en Visual Studio Code y añadir solo las extensiones que el equipo haya elegido para formatear, analizar, depurar o trabajar con el framework utilizado. Después, prueba la configuración con el mismo repositorio y documenta las extensiones recomendadas.
2.3. Extensiones recomendadas para el espacio de trabajo¶
Cuando varias personas trabajan en el mismo repositorio, es preferible
compartir recomendaciones en lugar de obligar a cada persona a recordar una
lista. Visual Studio Code permite guardar identificadores de extensiones
recomendadas en .vscode/extensions.json.
Un ejemplo mínimo sería:
Esta lista recomienda extensiones, pero no sustituye a la instalación del intérprete, de las dependencias ni de las herramientas de línea de comandos. La configuración del proyecto debe explicar también qué versión de Python se usa y qué comandos deben ejecutarse.
3. Linters y formateadores de código¶
Los linters y los formateadores se complementan, pero resuelven problemas distintos:
- un linter analiza el código para detectar errores potenciales, malas prácticas, nombres problemáticos, variables sin usar o construcciones que pueden causar fallos;
- un formateador aplica automáticamente reglas de presentación, como sangrías, espacios, saltos de línea y, según la herramienta, ordenación de importaciones.
Un formateador no demuestra que el programa sea correcto. Del mismo modo, un linter no debe confundirse con una suite de pruebas: analiza el código según sus reglas, pero no comprueba todos los comportamientos posibles.
3.1. Instalación para Python en Visual Studio Code¶
En Visual Studio Code puedes buscar las extensiones oficiales de Microsoft para Pylint y autopep8. En la documentación actual de Python para VS Code, estas herramientas se distribuyen como extensiones específicas, separadas de la extensión principal de Python.
Un flujo básico es:
- Instala la extensión Python.
- Abre la paleta de comandos y ejecuta Python: Select Interpreter.
- Selecciona el intérprete del proyecto, preferiblemente el de su entorno virtual.
- Instala la extensión de Pylint para el análisis estático.
- Instala la extensión de autopep8 si ese es el formateador acordado por el proyecto.
- Abre un archivo
.pyy revisa los diagnósticos del editor y del panel Problems.
Si el proyecto exige que las herramientas estén en el entorno virtual, puedes instalarlas desde la terminal activando previamente ese entorno:
En Windows puede ser necesario utilizar py o la ruta al intérprete del
entorno. Lo importante es que el IDE y la terminal utilicen el mismo intérprete;
de lo contrario, una extensión puede informar de que Pylint o autopep8 no están
instalados aunque sí existan en otra instalación de Python.
3.2. Configuración del linter¶
Pylint puede ejecutarse al abrir o guardar un archivo y mostrar advertencias en el editor y en Problems. La extensión permite configurar aspectos como el intérprete, la estrategia de instalación, los argumentos y el nivel de las notificaciones.
Por ejemplo, si el equipo quiere recibir avisos siempre que se ejecute el
linter, se puede establecer la opción de notificaciones de la extensión en
always, siempre que esa opción esté disponible en la versión instalada. La
configuración debe acordarse con el equipo para no ocultar avisos relevantes ni
generar ruido innecesario.
3.3. Configuración del formateador¶
Para seleccionar autopep8 como formateador de Python:
- Abre un archivo
.py. - Selecciona Format Document With....
- Elige Configure Default Formatter....
- Selecciona la extensión de autopep8.
- Si el equipo lo acuerda, activa el formateo al guardar con la opción
editor.formatOnSavedentro del ámbito de Python.
Una configuración de ejemplo sería:
No conviene activar varios formateadores a la vez. Si el proyecto utiliza Black, Ruff u otra herramienta, debe elegirse una política única y documentarla para evitar que cada guardado reescriba el código de una manera diferente.
4. Gestión de módulos y plugins en JetBrains¶
Los productos de JetBrains, como IntelliJ IDEA y PyCharm, permiten ampliar el IDE mediante plugins y organizar los proyectos mediante módulos. En versiones actuales, la documentación de JetBrains diferencia claramente ambos conceptos. Los apuntes anteriores también citaban Fleet, pero debe tratarse como una referencia histórica: antes de recomendar su instalación hay que comprobar su disponibilidad y consultar la actualización sobre Fleet incluida en 2.1. Entornos de desarrollo integrado.
4.1. Plugins y módulos no son lo mismo¶
Un plugin amplía el propio IDE. Puede añadir soporte para un lenguaje, un framework, un sistema de control de versiones, un tipo de prueba o una integración con un servicio.
Un módulo de proyecto es una unidad lógica del proyecto. Puede contener una o varias raíces de contenido, código fuente, pruebas, recursos, dependencias, un SDK y su propia configuración. Un proyecto puede tener varios módulos, por ejemplo uno para el cliente web y otro para el servidor.
Por tanto:
- instalar un plugin de Kotlin añade o mejora el soporte del IDE para Kotlin;
- crear un módulo Kotlin organiza una parte concreta del proyecto que utiliza Kotlin;
- instalar soporte para Django depende del plugin o de las capacidades del IDE, mientras que un módulo puede representar una aplicación Django dentro de un proyecto mayor.
Aclaración terminológica
En algunos apuntes se usa «módulo» como sinónimo general de «complemento». Para configurar JetBrains con precisión, reserva plugin para la extensión del IDE y módulo para la estructura del proyecto.
4.2. Instalación de módulos en IntelliJ IDEA¶
Para añadir un módulo a un proyecto de IntelliJ IDEA:
- Selecciona el directorio superior del proyecto en la ventana Project.
- Pulsa el botón Add o utiliza
Alt + Inserty elige Module. - En el asistente, selecciona el lenguaje o la tecnología disponible.
- Si la tecnología necesita un plugin que no está instalado, utiliza la opción para buscarlo mediante plugins y revisa sus requisitos.
- Indica el nombre del módulo.
- Selecciona el sistema de construcción, como el constructor de IntelliJ, Maven o Gradle, cuando proceda.
- Selecciona el SDK o JDK que utilizará el módulo.
- Pulsa Create y comprueba las raíces de código, dependencias y nivel de lenguaje.
También se puede abrir File > Project Structure > Modules para revisar, crear, importar o ajustar los módulos existentes. El asistente y las opciones visibles pueden variar según la edición, la versión del IDE y los plugins instalados.
4.3. Instalación de plugins en JetBrains¶
Para instalar un plugin en IntelliJ IDEA o PyCharm:
- Abre File > Settings en Windows y Linux o Preferences en macOS.
- Selecciona Plugins.
- En la pestaña Marketplace, busca el plugin por su nombre.
- Comprueba el editor, la versión compatible, las dependencias y la licencia.
- Pulsa Install y reinicia el IDE si lo solicita.
En la pestaña Installed puedes activar, desactivar, actualizar o desinstalar los plugins no integrados. Los plugins incluidos de serie pueden tener restricciones distintas y no siempre se pueden desinstalar.
Un ejemplo es Kotest para trabajar con pruebas en Kotlin. Se busca desde Plugins, se instala si es compatible con la versión del IDE y se reinicia cuando sea necesario. La instalación del plugin no sustituye a declarar la dependencia de Kotest en el sistema de construcción del proyecto.
5. Linters y formateadores en PyCharm mediante herramientas externas¶
PyCharm incorpora inspecciones y funciones de calidad, pero también permite ejecutar programas externos desde el IDE. Esta opción es útil cuando el equipo quiere utilizar exactamente las mismas herramientas que ejecuta en la terminal o en integración continua.
5.1. Instalar las herramientas en el intérprete del proyecto¶
Antes de configurar PyCharm, instala las herramientas en el mismo entorno virtual que utiliza el proyecto:
También puedes usar la ventana Python Packages de PyCharm para localizar e instalar los paquetes. Después, comprueba en Settings > Project > Python Interpreter que PyCharm tiene seleccionado ese entorno.
Evita mezclar intérpretes
Si instalas Pylint en el Python del sistema, pero PyCharm usa un entorno virtual, el IDE puede no encontrar el ejecutable o puede analizar con una versión distinta a la del equipo. Las herramientas de calidad deben estar asociadas al intérprete y a las dependencias del proyecto que realmente se utiliza.
5.2. External Tool: autopep8¶
Una External Tool permite lanzar un programa de línea de comandos desde Tools > External Tools. Para configurar autopep8:
- Abre Settings / Preferences > Tools > External Tools.
- Pulsa + y crea una herramienta local.
-
Utiliza una configuración equivalente a la siguiente:
-
Name:
Autopep8. - Group:
External Tools. - Description:
Autopep8. - Program:
autopep8si está disponible en elPATH, o$PyInterpreterDirectory$/autopep8. - Arguments:
--in-place --aggressive --aggressive $FilePath$. - Working directory:
$ProjectFileDir$.
Si el sistema no encuentra el ejecutable directamente, una alternativa es usar el Python del proyecto como programa y pasar el módulo como argumento:
- Program:
$PyInterpreterDirectory$/pythonen Linux y macOS, o el equivalentepython.exeen Windows. -
Arguments:
-m autopep8 --in-place --aggressive --aggressive $FilePath$. -
En Advanced Options, activa Synchronize files after execution y Open console for tool output.
- Puedes añadir el filtro de salida siguiente para enlazar mensajes con el archivo y la posición:
- Guarda la configuración y ejecútala desde Tools > External Tools > Autopep8 con un archivo Python abierto.
La opción --in-place indica que autopep8 modifica el archivo directamente.
Las opciones --aggressive aumentan la intensidad de la reescritura. Antes de
usarlas en un proyecto existente, revisa los cambios y acuerda las reglas de
formato con el equipo.
5.3. External Tool: pylint¶
Para configurar Pylint como herramienta externa:
- Abre Settings / Preferences > Tools > External Tools y pulsa +.
-
Completa la herramienta con valores como estos:
-
Name:
Pylint. - Group:
External Tools. - Description:
Analizador de código estático de Python. - Program:
$PyInterpreterDirectory$/pylinto la ruta equivalente al ejecutable de Pylint en el entorno del proyecto. - Arguments:
--output-format=text $FilePath$. -
Working directory:
$ProjectFileDir$. -
Activa Synchronize files after execution y Open console for tool output en Advanced Options.
- Mantén el filtro de salida
$FILE_PATH$:$LINE$:$COLUMN$:.*o adáptalo al formato que use la versión de Pylint instalada. - Guarda la configuración y pruébala desde Tools > External Tools > Pylint.
El formato de salida puede personalizarse con las opciones de Pylint para que incluya ruta, línea, columna y mensaje. Si el filtro no coincide con la salida real, el análisis puede ejecutarse correctamente aunque PyCharm no convierta los avisos en enlaces navegables.
5.4. File Watcher: autopep8 al guardar¶
Un File Watcher ejecuta automáticamente una herramienta de línea de comandos cuando cambia o se guarda un archivo. En PyCharm, la opción se encuentra en Settings / Preferences > Tools > File Watchers. La documentación actual de PyCharm indica que el plugin File Watchers está disponible en PyCharm Pro; comprueba la edición instalada antes de seguir estos pasos.
Para autopep8, crea un watcher personalizado con una configuración equivalente a la siguiente:
Files to Watch
- File type:
Python. - Scope:
Project Files.
Tool to Run on Changes
- Program:
$PyInterpreterDirectory$/autopep8. - Arguments:
--in-place $FilePath$. - Output paths to refresh: vacío, porque se reescribe el archivo de origen.
- Working directory:
$ProjectFileDir$. - Environment variables: vacío, salvo que el proyecto necesite alguna variable concreta.
Advanced Options
- Activa Auto-save edited files to trigger the watcher solo si se quiere formatear mientras se trabaja.
- Activa Trigger the watcher on external changes únicamente si también se deben procesar cambios hechos fuera de PyCharm.
- Deja desactivada Trigger the watcher regardless of syntax errors para no intentar formatear archivos que todavía son sintácticamente inválidos.
- Usa Show console: On error para no abrir una consola en cada guardado.
- Si se necesita enlazar errores, configura un filtro de salida compatible con los mensajes de la herramienta.
El nombre File Watcher no significa que la herramienta conozca el lenguaje por sí misma: el watcher solo observa archivos y lanza el comando configurado. La calidad del resultado depende de la versión de autopep8, de sus argumentos y del intérprete seleccionado.
5.5. File Watcher: pylint al guardar¶
Para ejecutar Pylint automáticamente sobre el archivo modificado, crea otro watcher personalizado:
Files to Watch
- File type:
Python. - Scope:
Project Files.
Tool to Run on Changes
- Program:
$PyInterpreterDirectory$/pylint. - Arguments:
$FilePath$. - Output paths to refresh: vacío.
- Working directory:
$ProjectFileDir$.
Advanced Options
- Activa Auto-save edited files to trigger the watcher solo si el equipo acepta el coste de ejecutar Pylint durante la edición.
- Activa Trigger the watcher on external changes si el repositorio recibe cambios que también deben analizarse automáticamente.
- Usa Show console: On error y configura un filtro si necesitas navegar a las líneas advertidas.
Un watcher no sustituye al análisis ejecutado en la integración continua. El watcher proporciona feedback rápido en local; la comprobación compartida debe seguir ejecutándose con una configuración versionada y reproducible.
6. Desinstalación y actualización de extensiones, plugins y módulos¶
Los complementos tienen un ciclo de vida: se instalan, se configuran, se actualizan, se desactivan temporalmente o se eliminan. Revisarlo evita acumular funciones que ya no se necesitan y reduce conflictos entre versiones.
6.1. Desinstalación y actualización en Visual Studio Code¶
Desde la vista Extensiones de Visual Studio Code puedes:
- seleccionar el engranaje de una extensión y elegir Uninstall para desinstalarla;
- elegir Disable para desactivarla globalmente o solo en el espacio de trabajo actual;
- consultar la vista de actualizaciones y pulsar Update;
- activar o desactivar la actualización automática de extensiones;
- listar, instalar o desinstalar extensiones desde la línea de comandos con
code --list-extensions,code --install-extensionycode --uninstall-extension.
Antes de desinstalar una extensión, comprueba si el proyecto la recomienda o si alguna configuración depende de ella. Después, abre el proyecto y ejecuta sus pruebas para detectar posibles efectos secundarios.
6.2. Instalación y mantenimiento en JetBrains¶
Desde File > Settings > Plugins o Preferences > Plugins puedes:
- instalar plugins desde JetBrains Marketplace;
- instalar un plugin desde un archivo local ZIP o JAR cuando exista una razón justificada;
- activar o desactivar un plugin sin eliminarlo;
- actualizarlo desde la pestaña Installed;
- desinstalar plugins no integrados;
- revisar el repositorio de actualización y las dependencias del plugin.
JetBrains también permite declarar Required Plugins para que el proyecto avise si falta un complemento necesario. Esta opción ayuda a reproducir el entorno, pero no reemplaza la documentación de la versión del IDE, del SDK, del intérprete y de las herramientas externas.
Si se utiliza JetBrains Toolbox para instalar y mantener varias versiones de los IDE, Toolbox gestiona las aplicaciones, pero no sustituye el gestor de plugins del IDE. Los complementos se siguen instalando, actualizando, desactivando o eliminando desde Plugins.
6.3. Comprobar la configuración después de un cambio¶
Después de actualizar o quitar un complemento:
- Reinicia el IDE si lo solicita.
- Comprueba que el lenguaje sigue siendo reconocido.
- Ejecuta el linter, el formateador, las pruebas y la configuración de depuración afectadas.
- Revisa la ventana de salida para detectar incompatibilidades.
- Anota la versión instalada y el motivo del cambio si el proyecto es compartido.
7. Enlaces y recursos de interés¶
Las instrucciones de los menús pueden cambiar. Estas páginas deben ser la referencia cuando la interfaz de la versión instalada no coincida exactamente con los pasos de este tema:
7.1. Extensiones en Visual Studio Code¶
- Extension Marketplace de Visual Studio Code.
- Extensión Python para Visual Studio Code.
- Entornos de Python en Visual Studio Code.
- Linting de Python en Visual Studio Code.
- Formateo de Python en Visual Studio Code.
- Extensión Pylint de Microsoft.
- Extensión autopep8 de Microsoft.
- Visual Studio Code Marketplace.
7.2. Plugins, módulos y herramientas de JetBrains¶
- Plugins en IntelliJ IDEA.
- Plugins en PyCharm.
- Módulos en IntelliJ IDEA.
- Estructura del proyecto en IntelliJ IDEA.
- Herramientas externas en PyCharm.
- File Watchers en PyCharm.
- Configuración de PyCharm.
- Instalación de plugins en PyCharm.
- JetBrains Toolbox.
8. Buenas prácticas¶
Para trabajar con módulos y extensiones con criterio profesional:
- Instala desde fuentes confiables: comprueba el editor, el identificador, la reputación, la actividad de mantenimiento, la licencia y los permisos.
- Añade solo lo necesario: cada complemento puede aumentar el consumo, generar conflictos o cambiar el comportamiento del IDE.
- Usa el intérprete del proyecto: instala Pylint y autopep8 en el entorno virtual que realmente utiliza el proyecto, no en una instalación de Python arbitraria.
- Mantén una política de formato: elige un formateador, fija sus opciones y evita que varias herramientas reescriban el mismo archivo con reglas diferentes.
- Versiona la configuración compartible: documenta o comparte las recomendaciones de extensiones, las tareas, los argumentos y las versiones, sin guardar rutas privadas ni credenciales.
- Separa feedback local y validación del equipo: un watcher acelera la respuesta mientras editas, pero las comprobaciones definitivas deben poder ejecutarse de forma automatizada y reproducible.
- Actualiza con control: prueba los plugins en una rama o en un entorno de prueba antes de aplicar cambios que puedan afectar a todo el equipo.
- Revisa el código modificado: autopep8 puede reescribir el archivo con
--in-place; comprueba el diff antes de confirmar los cambios.
9. Errores frecuentes¶
| Error frecuente | Por qué ocurre | Cómo evitarlo |
|---|---|---|
| Llamar «módulo» a cualquier plugin | La terminología se usa de forma genérica en algunos materiales | Distingue extensión de VS Code, plugin de JetBrains, módulo de proyecto y herramienta externa |
| Creer que instalar la extensión Python instala Python | Se confunde la integración del IDE con el intérprete del lenguaje | Instala Python por separado y selecciona el intérprete del proyecto |
| Confundir linter y formateador | Ambos pueden mostrar avisos cerca del código | Recuerda que el linter analiza problemas y el formateador reorganiza la presentación |
| Instalar Pylint en otro entorno virtual | El IDE y la terminal apuntan a intérpretes distintos | Selecciona el intérprete del proyecto y usa python -m pip en ese entorno |
| Configurar varios formateadores al guardar | Cada herramienta aplica reglas diferentes | Elige un formateador y revisa editor.defaultFormatter |
Ejecutar autopep8 --in-place sin revisar los cambios |
La herramienta modifica el archivo de origen | Revisa el diff y acuerda el alcance de las reescrituras |
| Activar todos los watchers y el auto-guardado | Se lanzan muchas tareas mientras se escribe | Limita el alcance, ejecuta al guardar y mide el impacto en el rendimiento |
| Confiar solo en el filtro de salida | El formato del mensaje cambia entre versiones | Comprueba la salida real de la herramienta y adapta el filtro |
| Instalar plugins sin comprobar permisos o mantenimiento | Se prioriza la comodidad sobre la seguridad | Revisa la ficha oficial, el editor, la licencia, las dependencias y las actualizaciones |
| Pensar que un watcher sustituye a la integración continua | El análisis local no garantiza una comprobación compartida | Mantén también comandos reproducibles en el proyecto o en la CI |
| Eliminar un plugin sin revisar la configuración | Puede dejar tareas, perfiles o proyectos sin soporte | Desactívalo primero, prueba el proyecto y documenta la decisión |
10. Resumen¶
En este tema has aprendido que:
- las extensiones y los plugins amplían las funciones de un IDE, mientras que los módulos de proyecto organizan el código y su configuración;
- Visual Studio Code gestiona extensiones desde el Marketplace y puede compartir
recomendaciones mediante
.vscode/extensions.json; - en JetBrains, el soporte para lenguajes y frameworks depende de plugins, mientras que los módulos representan partes del proyecto;
- un linter como Pylint y un formateador como autopep8 cumplen funciones diferentes y deben usar el intérprete correcto;
- PyCharm puede lanzar estas herramientas como External Tools o mediante File Watchers, pero la automatización local debe estar controlada;
- un entorno profesional debe ser seguro, mantenible, documentado y reproducible.
Idea clave
Añadir un complemento no es completar una colección: es tomar una decisión técnica. Instala solo lo que resuelve una necesidad, verifica cómo se integra con el proyecto, comprueba su resultado y conserva una configuración que el resto del equipo pueda reproducir.
11. Para seguir practicando¶
- Abre un proyecto Python en Visual Studio Code, selecciona su entorno virtual e instala las extensiones Python, Pylint y autopep8. Comprueba un aviso del linter y una modificación de formato.
- Crea en PyCharm las herramientas externas de autopep8 y Pylint. Ejecútalas primero manualmente y revisa la salida antes de crear los File Watchers.
- Configura un watcher de autopep8 limitado a un archivo de prueba. Cambia su
alcance a
Project Filessolo después de comprobar que no modifica archivos no deseados. - Añade una extensión recomendada a
.vscode/extensions.jsony documenta en el README del proyecto qué intérprete, paquetes y comandos son necesarios. - Compara dos plugins del Marketplace atendiendo a editor, permisos, compatibilidad, licencia, mantenimiento y dependencias. Justifica cuál incorporarías al proyecto.
- Revisa el banco de preguntas de la unidad sobre módulos y extensiones.
Bibliografía y fuentes¶
- Visual Studio Code: Extension Marketplace.
- Visual Studio Code: Python environments.
- Visual Studio Code: linting de Python.
- Visual Studio Code: formatting de Python.
- JetBrains: gestión de plugins en IntelliJ IDEA.
- JetBrains: módulos de IntelliJ IDEA.
- JetBrains: herramientas externas en PyCharm.
- JetBrains: File Watchers en PyCharm.
- Pylint: documentación oficial.
- autopep8: proyecto en PyPI.
- Normativa del módulo Entornos de Desarrollo.
- García García, Javier. Entornos de desarrollo integrados. Material de apoyo del repositorio; las pantallas y rutas pueden corresponder a versiones anteriores.