Adjuntar a procesos en ejecución con el depurador de Visual Studio

Puede adjuntar el depurador de Visual Studio a un proceso en ejecución en un equipo local o remoto. Después de ejecutar el proceso, seleccione Depurar>Adjuntar a Proceso o presione Ctrl+Alt+p en Visual Studio, y use el cuadro de diálogo Adjuntar a proceso para adjuntar el depurador al proceso.

Puede usar Asociar al proceso para depurar aplicaciones en ejecución en equipos locales o remotos, depurar varios procesos simultáneamente, depurar aplicaciones que no se crearon en Visual Studio o depurar ninguna aplicación que no haya iniciado desde Visual Studio con el depurador asociado. Por ejemplo, si ejecuta una aplicación sin el depurador y alcanza una excepción, puede adjuntar el depurador al proceso que ejecuta la aplicación y comenzar la depuración.

Sugerencia

¿No está seguro de si debe usar Adjuntar al proceso para su escenario de depuración? Consulte Escenarios comunes de depuración.

Adjuntar a un proceso en ejecución en tu máquina local

Para volver a asociar rápidamente a un proceso al que se adjuntó anteriormente, consulte Volver a asociar a un proceso.

A partir de la versión 17.10 preview 2 de Visual Studio 2022, el cuadro de diálogo Asociar al proceso ha cambiado. Si necesita instrucciones que coincidan con el cuadro de diálogo anterior, cambie a la vista de Visual Studio 2019 (selector de versión superior izquierda del artículo).

Para conectar con un proceso en el equipo local:

1. En Visual Studio, seleccione Depurar>Adjuntar a proceso (o presione Ctrl+Alt+P) para abrir el cuadro de diálogo Adjuntar a proceso.

2. Establezca el tipo de conexión en Local.

   En la mayoría de los escenarios de depuración local, puede usar Local. Algunos escenarios pueden requerir un tipo de conexión diferente. Para obtener más información, consulte otras secciones de este artículo o escenarios de depuración comunes.

   

3. En la lista Procesos disponibles , busque y seleccione el proceso o los procesos a los que desea asociar.

   • Para seleccionar rápidamente un proceso, escriba su nombre o primera letra en el cuadro Filtrar procesos .
   • Si no conoce el nombre del proceso, examine la lista o consulte Escenarios de depuración comunes para ver algunos nombres de proceso comunes.
   • Usa el botón Track Window (Seguimiento de ventana) para habilitar la selección de una ventana en tu ordenador, lo que establece el proceso.

   Sugerencia

   Los procesos pueden iniciarse y detenerse en segundo plano mientras el cuadro de diálogo Asociar al proceso está abierto, por lo que es posible que la lista de procesos en ejecución no siempre sea actual. Puede seleccionar Actualizar en cualquier momento para ver la lista actual.

4. En el campo Tipo de código, asegúrese de que aparece el tipo de código que planea depurar.

   La configuración automática predeterminada funciona para la mayoría de los tipos de aplicación, pero puede seleccionar un tipo de código específico para especificar manualmente el tipo del depurador.

5. Seleccione Asociar.

Sugerencia

En el escenario en que tenga varios procesos idénticos, utilice la columna Línea de comandos o los detalles del proceso de w3wp de la columna Título para identificar el proceso correcto.

Nota:

Puede asociarse a varias aplicaciones para la depuración, pero solo una aplicación está activa en el depurador a la vez. Puede establecer la aplicación activa en la barra de herramientas Ubicación de depuración de Visual Studio o en la ventana Procesos .

Adjuntar a un proceso en un equipo remoto

También puede seleccionar un equipo remoto en el cuadro de diálogo Adjuntar al proceso, ver una lista de los procesos disponibles que se ejecutan en ese equipo y adjuntar a uno o más de los procesos para depurar. El depurador remoto (msvsmon.exe) debe ejecutarse en el equipo remoto. Para obtener más información, consulte Depuración remota.

A partir de la versión 17.10 preview 2 de Visual Studio 2022, el cuadro de diálogo Asociar al proceso ha cambiado. Si necesita instrucciones que coincidan con el cuadro de diálogo anterior, cambie a la vista de Visual Studio 2019 (selector de versión superior izquierda del artículo).

Para asociar a un proceso en ejecución en un equipo remoto:

1. En Visual Studio, seleccione Adjuntar>a proceso (o presione Ctrl+Alt+P) para abrir el cuadro de diálogo Adjuntar a proceso.

2. Establezca el tipo de conexión en un tipo de conexión remota, como Remoto (Windows).

   En la mayoría de los escenarios para la depuración remota en Windows, puede usar Remote (Windows). Algunos escenarios, como la depuración de una aplicación contenerizada o de Linux, requieren un tipo de conexión diferente. Para obtener más información, consulte otras secciones de este artículo o escenarios de depuración comunes.

   Aparece la opción Destino de conexión.

3. En el cuadro Destino de conexión, seleccione el equipo remoto con uno de los métodos siguientes:

   • Seleccione la flecha de lista desplegable situada junto a Destino de conexión y seleccione el nombre del equipo en la lista desplegable.
   • Escriba el nombre del equipo en el cuadro Destino de conexión y presione Entrar.
   • Seleccione el botón Buscar situado junto al cuadro Destino de conexión para abrir el cuadro de diálogo Conexiones remotas . En el cuadro de diálogo Conexiones remotas se enumeran todos los dispositivos que se encuentran en la subred local o directamente conectados al equipo. Es posible que tenga que abrir el puerto UDP de salida 3702 en el servidor para detectar dispositivos remotos. Seleccione el equipo o el dispositivo que desee y, a continuación, cierre el cuadro de diálogo.

   Compruebe que Visual Studio agrega el puerto necesario al nombre del equipo, que se muestra en el formato: <nombre del equipo remoto>:puerto

   Nota:

   Si no puede conectarse con el nombre del equipo remoto, pruebe a usar la dirección IP y el puerto (por ejemplo, 123.45.678.9:4026). 4026 es el puerto predeterminado para el depurador remoto de Visual Studio 2022. Para ver otras asignaciones de puertos del depurador remoto, consulte Asignaciones de puertos del depurador remoto.

   La opción Tipo de conexión persiste entre las sesiones de depuración. La configuración de destino de conexión persiste entre sesiones de depuración solo si se produjo una conexión de depuración exitosa con ese destino.

4. Haga clic en Actualizar para rellenar la lista Procesos disponibles .

   Sugerencia

   Los procesos pueden iniciarse y detenerse en segundo plano mientras el cuadro de diálogo Asociar al proceso está abierto, por lo que es posible que la lista de procesos en ejecución no siempre sea actual. Puede seleccionar Actualizar en cualquier momento para ver la lista actual.

5. En la lista Procesos disponibles , busque y seleccione el proceso o los procesos a los que desea asociar.

   • Para seleccionar rápidamente un proceso, escriba su nombre o primera letra en el cuadro de búsqueda de procesos.

   • Si no conoce el nombre del proceso, examine la lista o consulte Escenarios de depuración comunes para ver algunos nombres de proceso comunes.

   • Para buscar procesos que se ejecutan en todas las cuentas de usuario, active la casilla Mostrar procesos de todos los usuarios .

     Nota:

     Si intenta vincularse a un proceso propiedad de una cuenta de usuario que no es de confianza, aparecerá un cuadro de diálogo de confirmación de advertencia de seguridad. Para obtener más información, vea Advertencia de seguridad: Adjuntar a un proceso propiedad de un usuario que no es de confianza puede ser peligroso. Si la siguiente información parece sospechosa o no está seguro, no se adjunte a este proceso.

6. En el campo Tipo de código, asegúrese de que aparece el tipo de código que planea depurar.

   La configuración automática predeterminada funciona para la mayoría de los tipos de aplicación, pero puede seleccionar un tipo de código específico para especificar manualmente el tipo del depurador.

7. Seleccione Asociar.

Nota:

Puede asociarse a varias aplicaciones para la depuración, pero solo una aplicación está activa en el depurador a la vez. Puede establecer la aplicación activa en la barra de herramientas Ubicación de depuración de Visual Studio o en la ventana Procesos .

En algunos casos, cuando estés depurando en una sesión de Escritorio Remoto (Servicios de Terminal), la lista Procesos disponibles no mostrará todos los procesos disponibles. Si ejecuta Visual Studio como usuario que tiene una cuenta de usuario limitada, la lista Procesos disponibles no mostrará los procesos que se ejecutan en la sesión 0. La sesión 0 se usa para servicios y otros procesos de servidor, incluidos w3wp.exe. Para solucionar el problema, ejecute Visual Studio en una cuenta de administrador o ejecute Visual Studio desde la consola del servidor en lugar de una sesión de Escritorio remoto.

Si ninguna de esas soluciones alternativas es posible, una tercera opción es adjuntar al proceso mediante la ejecución vsjitdebugger.exe -p <ProcessId> desde la línea de comandos de Windows. Puede determinar el identificador de proceso mediante tlist.exe. Para obtener tlist.exe, descargue e instale Herramientas de Depuración para Windows, disponibles en Descargas de WDK y WinDbg.

Adjuntar a un proceso de .NET Core que se está ejecutando en Azure App Service (Windows)

Si va a publicar en Azure App Service (Windows), consulte Depuración remota ASP.NET Core en Azure o Depuración de Azure App Service para obtener instrucciones.

Asociación a un proceso de .NET Core que se ejecuta en Linux mediante SSH

Para más información, consulte Depuración remota de .NET Core que se ejecuta en Linux mediante SSH.

Conectar a un proceso que se ejecuta en un contenedor de Docker

A partir de Visual Studio 2019, puede adjuntar el depurador de Visual Studio a un proceso que se ejecuta en un contenedor de Docker. Para un contenedor de Docker de .NET Core de Linux, consulte Adjuntar a un proceso en ejecución en un contenedor de Docker de Linux. Para un contenedor de Docker de Windows, consulte Adjuntar a un proceso que se ejecuta en un contenedor de Docker de Windows.

Volver a conectar a un proceso

Puede rehacer la conexión rápidamente con los procesos a los que previamente estaba conectado eligiendo Depurar>Volver a Adjuntar al Proceso (Mayús+Alt+P). Al elegir este comando, el depurador intentará asociar inmediatamente a los últimos procesos a los que adjuntó primero intentando coincidir con el identificador de proceso anterior y, si se produce un error, haciendo coincidir con el nombre del proceso anterior. Si no se encuentran coincidencias o si varios procesos tienen el mismo nombre, se abrirá el cuadro de diálogo Asociar al proceso para que pueda seleccionar el proceso correcto.

Nota:

El comando Volver a adjuntar al proceso está disponible a partir de Visual Studio 2017.

Escenarios comunes de depuración

Para ayudarle a determinar si se debe usar Asociar al proceso y a qué proceso se va a asociar, en la tabla siguiente se muestran algunos escenarios de depuración comunes, con vínculos a más instrucciones cuando estén disponibles. (La lista no es exhaustiva).

Para seleccionar rápidamente un proceso en ejecución al que asociar, en Visual Studio, escriba Ctrl+Alt+P y, a continuación, escriba la primera letra del nombre del proceso.

Para que el depurador se conecte al código escrito en C++, el código debe emitir DebuggableAttribute. Puede agregar esto automáticamente a su código vinculándolo con la opción del enlazador /ASSEMBLYDEBUG.

Para la depuración de scripts del lado cliente, la depuración de scripts debe estar habilitada en el explorador. Para depurar el script del lado cliente en Chrome, elija JavaScript o TypeScript como tipo de código y, en función del tipo de aplicación, es posible que tenga que cerrar todas las instancias de Chrome e iniciar el explorador en modo de depuración (escriba chrome.exe --remote-debugging-port=9222 desde una línea de comandos).

Scenario	Método de depuración	Nombre del proceso	Notas y vínculos
ASP.NET Core: depuración remota en el servidor de Internet Information Services (IIS)	Usar herramientas remotas y Conectar al proceso	w3wp.exe o dotnet.exe	A partir de .NET Core 3, el proceso w3wp.exe se usa para el modelo de hospedaje predeterminado dentro de la aplicación. Para la implementación de aplicaciones, consulte Publicar en IIS. Para obtener información más detallada, consulte Depuración remota ASP.NET Core en un equipo remoto de IIS.
ASP.NET Core: depuración en el equipo local, una vez que has iniciado la aplicación sin el depurador	Utilice Adjuntar al proceso	appname.exe o iisexpress.exe	Esto puede resultar útil para que la aplicación se cargue más rápido, como (por ejemplo) al generar perfiles. El proceso predeterminado del servidor local (kestrel) para ASP.NET Core es appname.exe.
ASP.NET 4 o 4.5: depuración remota en un servidor IIS	Uso de herramientas remotas y Adjuntar al proceso	w3wp.exe	Consulte depuración remota en ASP.NET en un equipo IIS remoto.
Script del lado cliente: depuración en un servidor IIS local para los tipos de aplicación admitidos	Adjuntar al proceso	chrome.exe o msedge.exe	La depuración de scripts debe estar habilitada. Para Chrome, también debe ejecutar Chrome en modo de depuración (escriba chrome.exe --remote-debugging-port=9222 desde una línea de comandos) y seleccione JavaScript o TypeScript en el campo Adjuntar a.
Depuración de una aplicación en C#, Visual Basic o C++ en el equipo local	Usa la depuración estándar (F5) o Adjuntar al proceso	{appname}.exe	En la mayoría de los escenarios, utilice la depuración estándar y no Adjuntar al Proceso.
Aplicación de escritorio de Windows: depuración remota	Herramientas remotas	N/A	Consulte Depuración remota de una aplicación de C# o Visual Basic oDepuración remota de una aplicación de C++
.NET Core en Linux: depuración	Usar Adjuntar al proceso	dotnet.exe o un nombre de proceso único	Para usar SSH, consulte Depuración remota de .NET Core que se ejecuta en Linux mediante SSH. Para las aplicaciones en contenedores, consulte Asociación a un proceso que se ejecuta en un contenedor de Docker.
Aplicación en contenedor: depuración	Usa Adjuntar al Proceso	dotnet.exe o un nombre de proceso único	Consulte Asociación a un proceso que se ejecuta en un contenedor de Docker.
Python en Linux: depuración remota	Usa Adjuntar a Proceso	debugpy	Consulte cómo adjuntar remotamente desde Python Tools.
Otros tipos de aplicaciones compatibles: depuración en un proceso de servidor	Si el servidor es remoto, utilice herramientas remotas y Adjuntar al proceso.	chrome.exe, msedge.exeu otros procesos	Si es necesario, use Resource Monitor para ayudar a identificar el proceso. Consulte Depuración remota.
Aplicación para la Plataforma universal de Windows (UWP), OneCore, HoloLens o aplicación de IoT: depuración remota	Depuración del paquete de aplicación instalado	N/A	Consulte Depurar un paquete de aplicación instalado en lugar de usar Adjuntar al proceso.
Aplicación UWP, OneCore, HoloLens o IoT: depurar una aplicación que no se inició desde Visual Studio	Depuración del paquete de aplicación instalado	N/A	Consulte Depurar un paquete de aplicación instalado en lugar de usar Adjuntar al proceso.

Uso de funciones del depurador

Para usar las características completas del depurador de Visual Studio (como alcanzar puntos de interrupción) al asociarse a un proceso, la aplicación debe coincidir exactamente con el origen y los símbolos locales. Es decir, el depurador debe poder cargar los archivos de símbolos correctos (.pdb). De forma predeterminada, esto requiere una compilación de depuración.

Para escenarios de depuración remota, debe tener el código fuente (o una copia del código fuente) ya abierto en Visual Studio. Los archivos binarios de la aplicación compilados en la máquina remota deben proceder de la misma compilación que en el equipo local.

En algunos escenarios de depuración local, puede depurar en Visual Studio sin acceso al origen si los archivos de símbolos correctos están presentes con la aplicación. De forma predeterminada, esto requiere una compilación de depuración. Para obtener más información, vea Especificar archivos de código fuente y símbolos.

Solución de problemas de errores de adjunto

En algunos escenarios, es posible que el depurador necesite ayuda para identificar correctamente el tipo de código que se va a depurar. Si los valores de conexión se establecen correctamente (puede ver el proceso correcto en la lista Procesos disponibles ), pero el depurador no se puede asociar, intente seleccionar el depurador más adecuado en la lista Tipo de código , que podría ser necesario, por ejemplo, si está depurando una aplicación de Linux o Python.

A veces, el depurador puede acoplarse con éxito a un tipo de código, pero no a otro. Normalmente, esto ocurre cuando:

• Intenta asociar a un proceso que se ejecuta en un equipo remoto. Es posible que el equipo remoto tenga componentes de depuración remota instalados para algunos tipos de código, pero no para otros.
• Intenta conectar a dos o más procesos para la depuración directa de una base de datos. La depuración de SQL solo admite la vinculación a un proceso único.

Si el depurador puede asociarse a algunos tipos de código, pero no todos, verá un mensaje que identifica qué tipos no se pudieron asociar.

Si el depurador se asocia correctamente a al menos un tipo de código, puede continuar con la depuración del proceso. Podrá depurar solo los tipos de código que se adjuntaron correctamente. El código no conectado del proceso se seguirá ejecutando, pero no podrá establecer puntos de interrupción, ver datos ni realizar otras operaciones de depuración en ese código.

Si desea obtener información más específica sobre por qué el depurador no pudo asociarse a un tipo de código, intente volver a asociarlo solo a ese tipo de código.

Obtener información específica sobre por qué no se pudo adjuntar un tipo de código

1. Desconéctese del proceso. En el menú Depurar, seleccione Separar todo.

2. Vuelva a adjuntar al proceso y seleccione solo el tipo de código que no se pudo adjuntar.

   1. En el cuadro de diálogo Asociar al proceso, seleccione el proceso en la lista Procesos disponibles .

   2. En la opción Tipo de código, seleccione el tipo de código que no se pudo adjuntar. Anule la selección de los otros tipos de código.

   3. En el cuadro de diálogo Asociar al proceso , seleccione Asociar.

   Esta vez, el adjunto fallará completamente y recibirá un mensaje de error específico.

Contenido relacionado

• Depurar varios procesos
• Depuración Just-In-Time
• Depuración remota