Tutorial: Aprenda a depurar código de C# mediante Visual Studio

En este artículo se presentan las características del depurador de Visual Studio en un tutorial paso a paso. Normalmente, depurar una aplicación significa ejecutar la aplicación con el depurador activado. Al realizar esta tarea, el depurador proporciona muchas maneras de ver lo que hace el código mientras se ejecuta. Puede recorrer el código y examinar los valores almacenados en variables. Puede establecer relojes en variables para ver cuándo cambian los valores. Puede examinar la ruta de ejecución de su código para ver si se está ejecutando una sección del código.

Si este artículo es la primera vez que intenta depurar código, consulte Depurar para principiantes absolutos. Si quiere una vista de nivel superior de las características del depurador, consulte Información general del depurador de Visual Studio.

Aunque la aplicación de demostración es C#, la mayoría de las características son aplicables a C++, Visual Basic, F#, Python, JavaScript y otros lenguajes compatibles con Visual Studio. F# no admite "Edit-and-continue". F# y JavaScript no admiten la ventana Automático . Las capturas de pantalla se encuentran en C#.

En este tutorial, hará lo siguiente:

• Iniciar el depurador y alcanzar puntos de interrupción
• Aprenda comandos para navegar por el código en el depurador
• Inspeccionar variables en la información sobre datos y las ventanas del depurador
• Examine la pila de llamadas

Prerrequisitos

Debe tener Visual Studio instalado y la carga de trabajo de desarrollo de escritorio de .NET.

Si necesita instalar Visual Studio, puede obtenerlo de forma gratuita en descargas de Visual Studio.

Si ya tiene Visual Studio, pero la carga de trabajo de desarrollo de escritorio de .NET no está instalada, vaya a Herramientas>Obtener herramientas y características.... En el Instalador de Visual Studio, elija la carga de trabajo de desarrollo de escritorio de .NET y luego elija Modificar.

Creación de un proyecto

En primer lugar, cree un proyecto de aplicación de consola de C#/.NET. La plantilla de proyecto incluye todos los archivos que necesita antes de agregar nada.

1. Abra Visual Studio. Si la ventana de inicio no está abierta, seleccione Archivo>Ventana de inicio.

2. En la ventana de inicio, seleccione Crear un nuevo proyecto.

3. En el cuadro de búsqueda de la ventana Crear un proyecto, escriba consola. A continuación, elija de C# en la lista Lenguaje y, a continuación, elija Windows en la lista Plataforma.

   Después de aplicar los filtros de lenguaje y plataforma, elija la plantilla Aplicación de consola y, luego, seleccione Siguiente.

   

   Nota

   Si no ve la plantilla Aplicación de Consola, puede instalarla desde la ventana Crear un nuevo proyecto. En el mensaje ¿No encuentras lo que estás buscando?, elige el vínculo Instalar más herramientas y características. A continuación, en el Instalador de Visual Studio, elija la carga de trabajo Desarrollo de escritorio de .NET.

4. En la ventana Configurar el nuevo proyecto, escriba GetStartedDebugging en el cuadro Nombre del proyecto. A continuación, seleccione Siguiente.

5. En la ventana Información adicional , asegúrese de que .NET 10.0 está seleccionado en el menú desplegable Marco y, a continuación, seleccione Crear.

Visual Studio abre el nuevo proyecto.

Creación de la aplicación

En Program.cs, reemplace todo el código predeterminado por el código siguiente:

using System;

class ArrayExample
{
   static void Main()
   {
      char[] letters = { 'f', 'r', 'e', 'd', ' ', 's', 'm', 'i', 't', 'h'};
      string name = "";
      int[] a = new int[10];
      for (int i = 0; i < letters.Length; i++)
      {
         name += letters[i];
         a[i] = i + 1;
         SendMessage(name, a[i]);
      }
      Console.ReadKey();
   }

   static void SendMessage(string name, int msg)
   {
      Console.WriteLine("Hello, " + name + "! Count to " + msg);
   }
}

Inicio del depurador

En su mayoría, en este artículo se usan métodos abreviados de teclado. Es una manera rápida de ejecutar comandos del depurador. Los comandos equivalentes, como los comandos de barra de herramientas o menús, también están disponibles.

1. Para iniciar el depurador, seleccione F5o elija el botón Destino de depuración de la barra de herramientas Estándar o elija el botón Iniciar depuración de la barra de herramientas Depurar o elija Depurar>Iniciar depuración en la barra de menús.

   

   F5 inicia la aplicación con el depurador asociado al proceso de aplicación. Desde que comenzaste a depurar, la aplicación se ejecuta hasta la finalización y ves la salida de la consola.

   Hello, f! Count to 1
   Hello, fr! Count to 2
   Hello, fre! Count to 3
   Hello, fred! Count to 4
   Hello, fred ! Count to 5
   Hello, fred s! Count to 6
   Hello, fred sm! Count to 7
   Hello, fred smi! Count to 8
   Hello, fred smit! Count to 9
   Hello, fred smith! Count to 10
   

2. Para detener el depurador, presione Mayús+F5 o elija el botón Detener depuración en la barra de herramientas de depuración. Otro modo es elegir Depurar>Detener depuración en la barra de menú.

   

3. En la ventana de la consola, seleccione cualquier tecla para cerrar la ventana de la consola.

Establecer un punto de interrupción e iniciar el depurador

1. En el bucle for de la función Main, establezca un punto de interrupción haciendo clic en el margen izquierdo en la siguiente línea de código:

   name += letters[i];

   Aparece un círculo rojo donde se establece el punto de interrupción.

   

   Los puntos de interrupción son una de las características esenciales para una depuración confiable. Puede establecer puntos de interrupción en los que desea que Visual Studio pause el código en ejecución. Puede examinar los valores de las variables o el comportamiento de la memoria o averiguar si se ejecuta una rama de código.

2. Para iniciar la depuración, seleccione F5o elija el botón Destino de depuración de la barra de herramientas Estándar o elija el botón Iniciar depuración de la barra de herramientas Depurar o elija Depurar>Iniciar depuración en la barra de menús. La aplicación se inicia y el depurador se ejecuta hasta la línea de código en la que haya establecido el punto de interrupción.

   

   La flecha amarilla apunta a la instrucción en la que se detuvo el depurador. La ejecución de la aplicación se detiene en el mismo punto, con la instrucción todavía no ejecutada.

   Cuando la aplicación no se está ejecutando, F5 inicia el depurador, que ejecuta la aplicación hasta que alcanza el primer punto de interrupción. Si la aplicación está en pausa en un punto de interrupción, F5 continúa ejecutando la aplicación hasta que llegue al siguiente punto de interrupción.

   Los puntos de interrupción son una característica útil cuando conoce la línea o sección del código que desea examinar con detalle. Para obtener más información sobre los distintos tipos de puntos de interrupción que puede establecer, como los puntos de interrupción condicionales, consulte Uso del tipo correcto de punto de interrupción.

Navegación por el código e inspección de los datos mediante sugerencias de datos

1. Mientras la ejecución de código está en pausa en la instrucción name += letters[i], mantenga el puntero sobre la variable letters para ver una sugerencia de datos que muestra el tamaño de matriz y el tipo de elemento, char[10].

   Nota

   Una de las características más útiles del depurador es su capacidad de inspeccionar una variable. A menudo, cuando intenta depurar un problema, está intentando averiguar si las variables tienen valores que espera en un momento determinado. Una buena forma de hacerlo es ver las sugerencias de datos.

2. Expanda la variable letters para ver todos sus elementos de matriz y sus valores.

   

3. Mantenga el puntero sobre la variable name para ver su valor actual, que es una cadena vacía.

4. Para avanzar el depurador a la siguiente instrucción, presione F10 o elija el botón Depurar paso a paso por procedimientos en la barra de herramientas de depuración. Otro modo es elegir Depurar>Depurar paso a paso por procedimientos en la barra de menú. Seleccione F10 dos veces más para pasar más allá de la llamada al método SendMessage.

   Al presionar F10 avanza el depurador sin depurar paso a paso por instrucciones la función ni los métodos, si bien el código todavía se ejecuta. De este modo, omitió la depuración del código en el método SendMessage, que no es relevante en este momento.

5. Para recorrer en iteración el bucle for varias veces, seleccione F10 repetidamente. Durante cada iteración del bucle, deténgase en el punto de interrupción y, luego, mantenga el puntero sobre la variable name para comprobar su valor en la sugerencia de datos.

   

   El valor de la variable cambia con cada iteración del bucle for, mostrando los valores de f, luego fr, luego fre, etc. Para hacer avanzar el depurador por el bucle más rápido, seleccione F5 en su lugar, que permite avanzar al punto de interrupción en lugar de a la instrucción siguiente.

6. Mientras la ejecución del código está en pausa en el bucle for del método Main, seleccione F11 o elija el botón Depurar paso a paso por instrucciones en la barra de herramientas de depuración. Otro modo es elegir Depurar>Depurar paso a paso por instrucciones en la barra de menú, hasta que llegue a la llamada de método SendMessage.

   El depurador debe pausarse en esta línea de código:

   SendMessage(name, a[i]);

7. Para entrar en el método SendMessage, vuelva a seleccionar F11.

   El puntero amarillo avanza hacia el método SendMessage.

   

   F11 le ayuda a examinar el flujo de ejecución del código en mayor profundidad. Para entrar en un método desde una llamada de método, seleccione F11. De forma predeterminada, el depurador omite la depuración paso a paso por instrucciones de métodos que no son de usuario. Para obtener información sobre cómo depurar código que no es de usuario, consulte Solo mi código.

   Después de finalizar la depuración del método SendMessage, está listo para volver al bucle for del método main.

8. Para salir del método SendMessage, presione Mayús+F11 o elija el botón Salir de la depuración de la barra de herramientas de depuración. Otro modo es elegir Depurar>Salir de la depuración en la barra de menú.

   La opción Salir de la depuración reanuda la ejecución de la aplicación y hace avanzar el depurador hasta que se devuelve el método o la función actuales.

   Ve el puntero amarillo de nuevo en el bucle for del método Main, detenido en la llamada de método SendMessage. Para más información sobre las distintas formas de desplazarse por el código, vea Navegación por el código en el depurador.

Navegación por el código con Ejecutar hasta clic

1. Seleccione F5 para avanzar al punto de interrupción de nuevo.

2. En el editor de código, pase el cursor sobre la llamada al método Console.WriteLine en el método SendMessage hasta que aparezca el botón Run to Click. La información sobre herramientas del botón muestra "Ejecutar hasta aquí".

   

3. Elija el botón Ejecutar hasta hacer clic. Como alternativa, con el cursor en la instrucción Console.WriteLine, seleccione Ctrl+F10. O bien, haga clic con el botón derecho en la llamada de método Console.WriteLine y elija Ejecutar hasta el cursor en el menú contextual.

   El depurador avanza hasta la llamada de método Console.WriteLine.

   El uso del botón Run to Click es similar a establecer un punto de interrupción temporal. Este enfoque es útil para moverse rápidamente dentro de una región visible del código de la aplicación en un archivo abierto.

Reinicio rápido de la aplicación

Para volver a ejecutar la aplicación desde el principio en el depurador, seleccione Ctrl+Mayús+F5o elija el botón Reiniciar de la barra de herramientas Depurar o elija Depurar>Reiniciar en la barra de menús.

Reiniciar detiene el depurador y, luego, lo reinicia, en un paso. Cuando se reinicie el depurador, se ejecuta hasta el primer punto de interrupción, que es el punto de interrupción que estableció anteriormente dentro del bucle for y, luego, se pausa.

Inspección de variables con las ventanas Automático y Variables locales

Las ventanas Automático y Variables locales muestran valores de variables durante la depuración. Las ventanas solo están disponibles durante una sesión de depuración. La ventana Automático muestra las variables usadas en la línea actual en la que se encuentra el depurador y en la línea anterior. La ventana Variables locales muestra las variables definidas en el ámbito local, que suele ser la función o el método actuales.

1. Mientras el depurador está en pausa, examine la ventana Automático de la parte inferior del editor de código.

   Si la ventana Automático está cerrada, presione Ctrl+D, A, o elija Depurar>Ventanas>Automático en la barra de menú.

2. Con el depurador aún en pausa, examine la ventana Variables locales, en una pestaña situada junto a la ventana Automático.

   Si la ventana Variables locales está cerrada, presione Ctrl+D, L, o elija Depurar>Ventanas>Variables locales.

3. En la ventana Variables locales, expanda la variable letters para ver sus elementos de matriz y sus valores.

   

Para obtener más información sobre las ventanas Automático y Locales, consulte Inspeccionar variables y valores devueltos.

Establecimiento de un reloj

Puede especificar una variable o una expresión en la que quiera mantener un ojo a medida que recorra el código agregándolo a la ventana Inspección .

1. Mientras el depurador está en pausa, haga clic con el botón derecho en la variable name y elija Agregar inspección.

   La ventana Inspección se abre, de forma predeterminada, en la parte inferior del editor de código.

2. Después de establecer el seguimiento en la variable name, recorra el código para ver el valor de la variable name cambiar con cada iteración del bucle for.

   A diferencia de las otras ventanas de variables, en la ventana Inspección siempre se muestran las variables que está viendo. Las variables que están fuera del ámbito se muestran como no disponibles.

Para obtener más información sobre la ventana Inspección, consulte Inspección de variables con las ventanas de inspección.

Examine la pila de llamadas

La pila de llamadas puede ayudarle a comprender el flujo de ejecución de la aplicación. Muestra el orden en que se están llamando los métodos y funciones.

1. Mientras el depurador está en pausa en el bucle for, examine la ventana Pila de llamadas, que se abre de forma predeterminada en el panel inferior derecho del editor de código.

   Si la ventana Pila de llamadas está cerrada, presione Ctrl+D, C, o elija Depurar>Ventanas>Pila de llamadas en la barra de menú.

   En la ventana Pila de llamadas, ve el puntero amarillo en el método Main actual.

2. Seleccione F11 varias veces hasta que el depurador se detenga en el método SendMessage.

   La línea superior de la ventana Pila de llamadas muestra la función actual, que es el método SendMessage. La segunda línea muestra que se llamó al método SendMessage desde el método Main.

   

   Nota

   La ventana Pila de llamadas es similar a la perspectiva de depuración de algunos IDE, como Eclipse.

   En la ventana Pila de llamadas, puede hacer doble clic en una línea de código para ir a ese código fuente, que cambia el ámbito actual bajo inspección por el depurador. Esta acción no hace avanzar el depurador.

   También puede usar los menús contextuales de la ventana Pila de llamadas para hacer otras cosas. Por ejemplo, puede insertar puntos de interrupción en funciones especificadas, hacer avanzar el depurador mediante la función Ejecutar hasta el cursor o ir al código fuente.

Para obtener más información sobre la pila de llamadas, consulte Visualización de la pila de llamadas.

Paso siguiente

En este tutorial, ha aprendido a iniciar el depurador, recorrer el código e inspeccionar variables. Es posible que usted desee obtener una visión general de las características del depurador junto con enlaces a más información.

Información general del depurador de Visual Studio