Szybki start: debugowanie przy użyciu języka C# lub Visual Basic przy użyciu debugera programu Visual Studio

W tym przewodniku Szybki start dowiesz się, jak używać debugera programu Visual Studio do debugowania aplikacji w języku C# lub Visual Basic. Ten artykuł zawiera szybki sposób na zapoznanie się z niektórymi podstawowymi funkcjami pracy w debugerze.

Jeśli nie masz programu Visual Studio, możesz zainstalować bezpłatną wersję próbną ze strony pobierania programu Visual Studio.

Tworzenie nowego projektu

Zacznij od utworzenia nowego projektu, więc masz kod do zaewidencjonowania w debugerze. W tym przykładzie tworzony jest projekt języka C# dla .NET.

  1. Otwórz program Visual Studio i utwórz nowy projekt.

    • Jeśli okno startowe nie jest otwarte, wybierz kolejno Plik>Okno startowe.

    • W oknie startowym wybierz pozycję Utwórz nowy projekt.

  2. W oknie Tworzenie nowego projektu ustaw filtry i wyszukaj szablon projektu.

    • W polu Wyszukaj szablony wpisz console.

    • Rozwiń listę rozwijaną Język i wybierz pozycję C#.

    • Rozwiń listę rozwijaną Platform i wybierz Windows.

  3. Na liście wyników wybierz szablon Aplikacja konsolowa , a następnie wybierz pozycję Dalej.

    Jeśli nie widzisz szablonu projektu Aplikacja konsolowa , wybierz opcję Kontynuuj bez kodu .

    1. Wybierz Tools>Pobierz narzędzia i funkcje... który otwiera Instalator Visual Studio.

    2. W oknie Instalatora zaznacz pole wyboru dla obciążenia roboczego Programowanie aplikacji klasycznych .NET, a następnie wybierz Modyfikuj.

      Instalacja programu Visual Studio zostanie zaktualizowana tak, aby uwzględniała wybrane obciążenie platformy .NET.

    3. Po zakończeniu aktualizacji wybierz Plik>Okno uruchamiania i postępuj zgodnie z poprzednimi instrukcjami, aby wybrać wymagany szablon.

  4. Skonfiguruj nowy projekt:

    1. Wprowadź nazwę Project i Nazwa rozwiązania lub użyj wartości domyślnych.

    2. Użyj domyślnej lokalizacji lub wybierz pozycję Przeglądaj (...), aby utworzyć projekt w innym folderze.

    3. Wybierz Dalej.

    4. Użyj zalecanej platformy docelowej Framework (domyślnie jest to .NET 10.0 LTS).

    5. Wybierz Utwórz.

    Visual Studio tworzy nowy projekt i dodaje pliki projektu w określonym folderze.

Aktualizowanie kodu projektu

Zaktualizuj część kodu dostarczonego przez szablon projektu, aby mieć więcej instrukcji do przetestowania w debugerze.

  1. W okienku Eksplorator rozwiązań wybierz element Program.cs.

    Plik Program.cs zostanie otwarty w edytorze kodu. (Jeśli pracujesz w Visual Basic, wybierz element Module1.vb).

  2. Zastąp zawartość pliku następującym kodem.

     internal class Program
     {
         private static void doWork()
         {
             LinkedList<int> c1 = new LinkedList<int>();
    
             c1.AddLast(10);
             c1.AddLast(20);
    
             LinkedList<int> c2 = new LinkedList<int>(c1);
             int i = c2.First.Value;
             int j = c2.First.Value;
             Console.Write("The first element is ");
             Console.Write(i);
             Console.Write("\n");
             Console.Write("The second element is ");
             Console.Write(j);
             Console.Write("\n");
         }
    
         static int Main()
         {
             // using namespace std;
             doWork();
             return 0;
         }
     }
    

    Zapisz zmiany za pomocą skrótu klawiaturowego Ctrl+S .


Ustawianie punktu przerwania

breakpoint to znacznik wskazujący, gdzie Visual Studio powinien zawiesić uruchomiony kod. Po ustawieniu punktu przerwania możesz przyjrzeć się bieżącym wartościom zmiennych, sprawdzić zachowanie pamięci i sprawdzić, czy działa określona gałąź kodu. Punkty przerwania to najbardziej podstawowa funkcja debugowania.

  1. Aby ustawić punkt przerwania, znajdź w kodzie wywołanie funkcji doWork(), a następnie kliknij lewy margines przy tym samym wierszu.

    Po ustawieniu punktu przerwania przy odpowiednim wierszu kodu w lewym marginesie pojawia się czerwona kropka.

    Screenshot pokazujący, jak ustawić punkt przerwania w debugerze Visual Studio.

    Screenshot pokazujący, jak ustawić punkt przerwania w debugerze Visual Studio 2022.

  2. Rozpocznij debugowanie przy użyciu skrótu klawiaturowego F5 (lub wybierz pozycję Debuguj>rozpocznij debugowanie).

    Screenshot przedstawiający wstrzymany debuger w ustawionym punkcie przerwania w Visual Studio.

    Zrzut ekranu przedstawiający debuger zatrzymany na ustawionym punkcie przerwania w programie Visual Studio 2022.

    Wykonywanie kodu jest wstrzymywane bezpośrednio przed wywołaniem doWork() funkcji.

    Debugger zatrzymuje się tam, gdzie ustawiono punkt przerwania. Żółta strzałka identyfikuje instrukcję, w której debuger wstrzymuje wykonywanie aplikacji.

Ustawianie warunkowych punktów przerwania

Jeśli ustawisz punkt przerwania w pętli lub rekursji lub jeśli masz wiele punktów przerwania, które często przechodzisz, użyj warunkowego punktu przerwania.

Takie podejście pomaga zapewnić, że kod jest zawieszony tylko wtedy, gdy zostaną spełnione określone warunki. Warunkowy punkt przerwania może zaoszczędzić czas, a także ułatwić debugowanie problemów, które są trudne do odtworzenia.

Zapoznaj się z kodem

Visual Studio udostępnia kilka różnych sposobów poinstruowania debugera o kontynuowaniu wykonywania aplikacji. Poniższy przykład przedstawia przydatne polecenie do przeglądania kodu.

Gdy kod jest wstrzymany w punkcie przerwania, umieść kursor na instrukcjic1.AddLast(20), aż zobaczysz zieloną ikonę Uruchom, aby kliknąć (uruchom wykonanie tutaj). Wybierz ikonę.

Zrzut ekranu pokazujący, jak używać polecenia „Run to Click” w debugerze programu Visual Studio.

Gdy kod jest wstrzymany w punkcie przerwania, umieść kursor na instrukcjic1.AddLast(20), aż zobaczysz zieloną ikonę Uruchom, aby kliknąć (uruchom wykonanie tutaj). Wybierz ikonę.

Zrzut ekranu pokazujący, jak korzystać z akcji Run to Click w debugerze programu Visual Studio 2022.

Aplikacja kontynuuje działanie, wywołuje doWork i zatrzymuje się w wierszu kodu, w którym wybrano opcję Uruchom do kliknięcia.

Często używane polecenia klawiatury do przechodzenia przez kod to F10 i F11. Aby uzyskać bardziej szczegółowe instrukcje, zobacz Przegląd debugera Visual Studio.

Inspekcja zmiennych w podpowiedziach danych

Stan zmiennych można sprawdzić przy użyciu funkcji porad dotyczących danych .

  1. W bieżącym wierszu kodu (oznaczonym żółtym wskaźnikiem wykonywania) najedź kursorem na obiekt c1, aby zobaczyć etykietkę danych.

    Screenshot przedstawiający sposób wyświetlania wskazówek dotyczących danych zmiennych kodu w debugerze Visual Studio.

    Screenshot przedstawiający sposób wyświetlania wskazówek dotyczących danych zmiennych kodu w debugerze Visual Studio 2022

    Porada dotycząca danych pokazuje bieżącą wartość zmiennej c1 i umożliwia sprawdzenie jej właściwości.

    Jeśli podczas debugowania widzisz nieoczekiwaną wartość zmiennej, prawdopodobnie występuje usterka. Usterka może znajdować się w kodzie, który wywołuje zmienną lub w poprzednim wierszu.

  2. Rozwiń podpowiedź danych, aby zobaczyć bieżące wartości właściwości obiektu c1.

  3. Aby nadal sprawdzać wartość c1 podczas wykonywania kodu, wybierz ikonę przypięcia na etykiecie danych.

    Akcja przypięcia pozostawia etykietę danych otwartą. W miarę wykonywania kodu wartość przypiętej wskazówki zmienia się, aby pokazać bieżący stan obserwowanego obiektu.

    Przypiętą wskazówkę można przenieść w dowolne miejsce w środowisku IDE, dzięki czemu nie zasłania innych elementów podczas debugowania.

Włącz gorące przeładowanie podczas debugowania

Jeśli podczas debugowania widzisz zmianę, którą chcesz przetestować w kodzie, możesz użyć funkcji Przeładowywanie na gorąco (wcześniej o nazwie Edit i Continue).

  1. Wybierz drugie wystąpienie instrukcji c2.First.Value i zmień kod na c2.Last.Value.

  2. Naciśnij klawisz F10 kilka razy (lub wybierz kilka razy Debug>Step Over), aby przejść przez kolejne kroki debugowania i wykonać edytowany kod.

    Animation, która pokazuje, jak edytować i kontynuować pracę z funkcją

    Animacja pokazująca, jak edytować i kontynuować przy użyciu funkcji „Przeładowywanie na gorąco” w debugerze programu Visual Studio 2022.

    F10 przesuwa uruchamianie debugera o jedną instrukcję na raz, ale przechodzi nad funkcjami zamiast wchodzić do nich (pomijany kod nadal się wykonuje).

Aby uzyskać więcej informacji na temat funkcji i ograniczeń, zobacz Konfigurowanie Przeładowywanie na gorąco.

Następny krok