Uso de PyLint para comprobar el código de Python

Se aplica a:Visual Studio Visual Studio para Mac Visual Studio Code

PyLint, una herramienta ampliamente usada que busca errores en el código de Python y promueve patrones correctos de codificación en Python, se integra en proyectos de Visual Studio para Python.

Ejecución de PyLint

En Visual Studio, haga clic con el botón derecho en un proyecto de Python en el Explorador de soluciones y selecciones Python, y luego Ejecutar PyLint:

Este comando le pide que instale PyLint en su entorno activo si no lo está todavía.

Las advertencias y errores de PyLint aparecen en la ventana Lista de errores:

Al hacer doble clic en un error se le dirigirá directamente al código fuente que ha generado el problema.

Sugerencia

Consulte la referencia de características de PyLint para obtener una lista detallada de todos los mensajes de salida de PyLint.

Configuración de las opciones de línea de comandos de PyLint

En la sección de opciones de línea de comandos de la documentación de PyLint se describe cómo controlar el comportamiento de PyLint mediante un archivo de configuración .pylintrc. Este archivo se puede colocar en la raíz de un proyecto de Python en Visual Studio, o bien en alguna otra parte, según cuán extensamente se quiera aplicar esa configuración (vea las opciones de línea de comandos para más información).

Por ejemplo, para suprimir las advertencias "falta docstring" que se muestran en la imagen anterior con un archivo .pylintrc en un proyecto, realice lo siguiente:

1. En la línea de comandos, vaya a la raíz del proyecto (que contiene su archivo .pyproj) y ejecute el siguiente comando para generar un archivo de configuración comentado:

   pylint --generate-rcfile > .pylintrc
   

2. En la ventana Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Agregar>Elemento existente. Después, vaya al nuevo archivo .pylintrc, selecciónelo y seleccione Agregar.

3. Abra el archivo para editarlo; que contiene una variedad de opciones de configuración con las que puede trabajar. Para deshabilitar una advertencia, busque la sección [MESSAGES CONTROL] y luego el valor disable en esa sección. Existe una cadena larga de mensajes concretos, a la que se puede anexar cualquier advertencia que quiera. En este ejemplo, anexe ,missing-docstring (incluida la coma de delimitación).

4. Guarde el archivo .pylintrc y ejecute PyLint de nuevo para ver que ahora las advertencias se han suprimido.

   Sugerencia

   Para usar un archivo .pylintrc desde un recurso compartido de red, cree una variable de entorno denominada PYLINTRC con el valor del nombre de archivo en el recurso compartido de red con una ruta de acceso de Convención de nomenclatura universal (UNC) o una letra de unidad asignada. Por ejemplo, PYLINTRC=\\myshare\python\.pylintrc.