Instalación de símbolos de depuración para intérpretes de Python en Visual Studio

En este artículo se proporcionan pasos para descargar e integrar símbolos de depuración para intérpretes de Python en Visual Studio.

Para proporcionar una experiencia de depuración completa, el depurador de Python en modo mixto de Visual Studio necesita símbolos de depuración para que el intérprete de Python analice numerosas estructuras de datos internas. Los símbolos de depuración se definen en archivos de base de datos de programa (.pdb). Por ejemplo, la biblioteca depython27.dll requiere el archivo de símbolos python27.pdb , la biblioteca depython36.dll usa el archivo de símbolos python36.pdb, etc. Cada versión del intérprete también proporciona archivos de símbolos para varios módulos.

• En Visual Studio 2017 y versiones posteriores, los intérpretes de Python 3 y Anaconda 3 instalan automáticamente sus respectivos símbolos y Visual Studio busca automáticamente los símbolos.

• En Visual Studio 2015 y versiones anteriores, o para otros intérpretes de código, debe descargar símbolos por separado y, a continuación, apuntar Visual Studio a los archivos.

Cuando Visual Studio detecta que faltan símbolos necesarios, un cuadro de diálogo le pide que realice una acción. Normalmente, verá un cuadro de diálogo al iniciar una sesión de depuración en modo mixto. El cuadro de diálogo incluye dos vínculos, uno de los cuales abre este artículo de documentación.

El cuadro de diálogo Configuración de símbolos abierta abre el panel Herramientas>Opciones a la sección Todos los ajustes>, Depuración> y Símbolos.

Prerrequisitos

• Visual Studio instalado con compatibilidad con cargas de trabajo de Python. Para obtener más información, consulte Instalación de compatibilidad con Python en Visual Studio.

Comprobación de la versión del intérprete

Los símbolos difieren entre compilaciones secundarias de Python y entre compilaciones de 32 y 64 bits. Es importante confirmar la versión y la compilación de Python para asegurarse de que tiene los símbolos correctos para el intérprete.

Para comprobar qué intérprete de Python está en uso:

1. En el Explorador de soluciones, expanda el nodo Entornos de Python en tu proyecto.

2. Busque el nombre del entorno actual (que se muestra en negrita).

3. Haga clic con el botón derecho en el nombre del entorno y seleccione Abrir ventana de comandos aquí.

   Se abre una ventana del símbolo del sistema en la ubicación de instalación del entorno actual.

4. Para iniciar Python, escriba el siguiente comando:

   python.exe
   

   El proceso de ejecución muestra la versión instalada de Python e indica si es de 32 o 64 bits:

   

Descargar símbolos

En los pasos siguientes se describe cómo descargar los símbolos necesarios para un intérprete de Python.

• Para Python 3.5 y versiones posteriores, adquiera los símbolos de depuración a través del instalador de Python.

  1. Seleccione Instalación personalizada y, a continuación, seleccione Siguiente.

  2. En la página Opciones avanzadas , seleccione los cuadros para Descargar símbolos de depuración y Descargar archivos binarios de depuración:

     

  Los archivos de símbolos (.pdb) se encuentran en la carpeta de instalación raíz. Los archivos de símbolos de los módulos individuales también se colocan en la carpeta DLL .

  Visual Studio busca estos símbolos automáticamente. No se necesitan más pasos.

• Para Python 3.4.x y versiones anteriores, los símbolos están disponibles como archivos descargables .zip de las distribuciones oficiales o de Enthought Canopy.

  1. Descargue el archivo de símbolos necesario.

     Importante

     Asegúrese de seleccionar el archivo de símbolos correspondiente a la versión instalada de Python y a la compilación (32 o 64 bits).

  2. Extraiga los archivos de símbolos en una carpeta local dentro de la carpeta python, como Símbolos.

  3. Después de extraer los archivos, el paso siguiente es Apuntar Visual Studio a los símbolos.

• Para otras distribuciones de Python de terceros, como ActiveState Python, póngase en contacto con los autores de esa distribución y pídale que le proporcione símbolos.

  WinPython incorpora el intérprete de Python estándar sin cambios. Puedes usar símbolos de la distribución oficial de WinPython para el número de versión correspondiente.

Indicar a Visual Studio los símbolos

Si descargó símbolos por separado, siga estos pasos para que Visual Studio conozca los símbolos.

Nota:

Si ha instalado símbolos mediante el instalador de Python 3.5 o posterior, Visual Studio busca automáticamente los símbolos. No es necesario completar los pasos de esta sección.

1. Abra el panel Herramientas>Opciones y expanda la sección Todas las configuraciones>Depuración>Símbolos>Ubicaciones de búsqueda.

2. En la barra de herramientas de la lista Ubicaciones del archivo de símbolos (.pdb), seleccione + Agregar.

3. En el cuadro de diálogo Agregar elemento , escriba la ruta de acceso de la carpeta donde extrajo los símbolos descargados y, a continuación, seleccione Guardar.

   Especifique la ubicación donde se encuentra el archivo python.pdb , como c:\python34\Symbols, como se muestra en la siguiente imagen.

   

Durante una sesión de depuración, Visual Studio también puede solicitarle la ubicación de un archivo de origen para el intérprete de Python. Si descargó archivos de origen, como desde python.org/downloads/, puede indicar a Visual Studio los archivos descargados.

Opciones de almacenamiento en caché de símbolos

La sección Todos los Ajustes>Depuración>Símbolos admite otras opciones para configurar el almacenamiento en caché de símbolos en las subsecciones Ubicaciones de Búsqueda y Buscar y Cargar. Visual Studio usa las características de almacenamiento en caché de símbolos para crear una caché local de símbolos obtenidos de un origen en línea.

Estas características no son necesarias con los símbolos del intérprete de Python porque los símbolos ya están presentes localmente. Para obtener más información, vea Especificar símbolos y archivos de origen en el depurador de Visual Studio.

Acceso a descargas para distribuciones oficiales

En la tabla siguiente se muestra la información de descarga de las versiones oficiales de Python.

Versión de Python	Downloads
3.5 y versiones posteriores	Instale símbolos a través del instalador de Python.
3.4.4	32 bits - 64 bits
3.4.3	32 bits - 64 bits
3.4.2	32 bits - 64 bits
3.4.1	32 bits - 64 bits
3.4.0	32 bits - 64 bits
3.3.5	32 bits - 64 bits
3.3.4	32 bits - 64 bits
3.3.3	32 bits - 64 bits
3.3.2	32 bits - 64 bits
3.3.1	32 bits - 64 bits
3.3.0	32 bits - 64 bits
2.7.18	32 bits - 64 bits
2.7.17	32 bits - 64 bits
2.7.16	32 bits - 64 bits
2.7.15	32 bits - 64 bits
2.7.14	32 bits - 64 bits
2.7.13	32 bits - 64 bits
2.7.12	32 bits - 64 bits
2.7.11	32 bits - 64 bits
2.7.10	32 bits - 64 bits
2.7.9	32 bits - 64 bits
2.7.8	32 bits - 64 bits
2.7.7	32 bits - 64 bits
2.7.6	32 bits - 64 bits
2.7.5	32 bits - 64 bits
2.7.4	32 bits - 64 bits
2.7.3	32 bits - 64 bits
2.7.2	32 bits - 64 bits
2.7.1	32 bits - 64 bits

Utilizar símbolos de Enthought Canopy

Enthought Canopy proporciona símbolos de depuración para sus archivos binarios a partir de la versión 1.2. Estos símbolos se instalan automáticamente junto con la distribución.

• Para usar los símbolos, agregue manualmente la carpeta que contiene los símbolos a la ruta de símbolos, como se describe en Apuntar Visual Studio a los símbolos.

  Para una instalación típica por usuario de Canopy, los símbolos se encuentran en las carpetas siguientes:

  • Versión de 64 bits: %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts
  • Versión de 32 bits: %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts

Enthought Canopy 1.1 y versiones anteriores, así como Enthought Python Distribution (EPD), no proporcionan símbolos de intérprete. Estas versiones no son compatibles con la depuración en modo mixto.

Contenido relacionado

• Especificar símbolos y archivos de origen en el depurador de Visual Studio
• Depurar Python y C++ juntos (depuración en modo mixto)