Debugowanie kodu źródłowego w usłudze WinDbg (wersja klasyczna)

Ścieżka źródłowa

Ścieżka źródłowa określa katalogi, w których znajdują się pliki źródłowe C i C++. Aby uzyskać więcej informacji na temat wyświetlania kodu źródłowego w debugerze, zobacz Ścieżka źródłowa.

Nuta Jeśli masz połączenie z siecią firmową, najbardziej efektywnym sposobem uzyskiwania dostępu do plików źródłowych jest użycie serwera źródłowego. Możesz użyć serwera źródłowego przy użyciu ciągu srv* w ścieżce źródłowej. Aby uzyskać więcej informacji na temat serwerów źródłowych, zobacz Używanie serwera źródłowego.

Aby kontrolować ścieżkę źródłową w usłudze WinDbg, wykonaj jedną z następujących czynności:

• Wybierz pozycję Ścieżka pliku źródłowego z menu Plik lub naciśnij CTRL+P.

• Użyj polecenia .srcpath (Ustaw ścieżkę źródłową). Jeśli używasz serwera źródeł, srcfix (Użycie serwera źródłowego) jest nieco łatwiejsze.

• Użyj polecenia .lsrcpath (Ustaw lokalną ścieżkę źródłową). Jeśli używasz serwera źródłowego, plik lsrcfix (Użyj lokalnego serwera źródłowego) jest nieco łatwiejszy.

• Po uruchomieniu debugera użyj opcji -srcpath lub -lsrcpath wiersza polecenia. Zobacz Opcje Command-Line WinDbg.

• Przed uruchomieniem debugera ustaw zmienną środowiskową _NT_SOURCE_PATH.

Otwieranie i zamykanie plików źródłowych

Aby otworzyć lub zamknąć plik źródłowy bezpośrednio, wykonaj jedną z następujących czynności:

• Wybierz pozycję Plik typu open source z menu Plik lub naciśnij CTRL+O. Możesz również użyć przycisku Plik open source (

  Nuta Gdy używasz menu lub przycisku paska narzędzi do otwierania pliku źródłowego, ścieżka tego pliku jest automatycznie dołączana do ścieżki źródłowej.

• Wybierz pozycję Zamknij bieżące okno z menu Plik .

• Wybierz przycisk Zamknij w rogu okna Źródło.

• Wybierz pozycję Ostatnie pliki z menu Plik , aby otworzyć jeden z czterech plików źródłowych, które zostały ostatnio otwarte w usłudze WinDbg.

• Wprowadź polecenie .open (plik open source).

• Wprowadź polecenie lsf (załaduj lub zwolnij plik źródłowy).

W systemie WinDbg w oknie Źródło zostaną wyświetlone pliki źródłowe, które zostały załadowane do debugera.

Otwieranie okna źródłowego

Debuger otwiera okno źródłowe podczas ładowania nowego pliku źródłowego. Aby przywrócić lub przełączyć się do okna open Source, przejdź do menu Okno i wybierz z listy okien w dolnej części menu.

Poniższy zrzut ekranu przedstawia przykład okna Źródło.

Każdy plik źródłowy znajduje się we własnym oknie Źródło. Tytuł każdego okna Źródło jest pełną ścieżką pliku źródłowego.

Korzystanie z okna źródłowego

Każde okno Źródło wyświetla tekst jednego pliku źródłowego. Nie można edytować pliku źródłowego w debugerze. Aby uzyskać więcej informacji na temat zmiany ustawień czcionki i karty, zobacz Zmienianie właściwości tekstu.

Każde okno Źródło ma menu skrótów z dodatkowymi poleceniami. Aby uzyskać dostęp do menu, wybierz i przytrzymaj (lub kliknij prawym przyciskiem myszy) pasek tytułu lub wybierz ikonę wyświetlaną w prawym górnym rogu okna. Poniższa lista zawiera opis niektórych poleceń menu:

• Ustaw wskaźnik instrukcji na bieżący wiersz zmienia wartość wskaźnika instrukcji na instrukcję odpowiadającą bieżącemu wierszowi. To polecenie jest równoważne użyciu funkcji Edytuj | Ustaw bieżącą instrukcję lub naciskając CTRL+SHIFT+I.

• Edytuj ten plik otwiera plik źródłowy w edytorze tekstów. Edytor jest określany przez informacje rejestru edytora WinDiff lub przez wartość zmiennej środowiskowej WINDBG_INVOKE_EDITOR. Rozważmy na przykład przypadek, gdy wartość WINDBG_INVOKE_EDITOR jest następująca.

  c:\my\path\myeditor.exe -file %f -line %l
  

  W takim przypadku Myeditor.exe otworzy się na jeden numer wiersza bieżącego pliku źródłowego. Opcja %l wskazuje, że numery wierszy powinny być odczytywane jako zaczynające się od jedynki, natomiast %f wskazuje, że należy użyć aktualnego pliku źródłowego. Inne możliwości podstawienia obejmują %L, co wskazuje, że numeracja linii zaczyna się od zera, oraz %p, co może także wskazywać, że powinien być użyty aktualny plik źródłowy.

• Ocena zaznaczenia oblicza aktualnie zaznaczony tekst przy użyciu ewaluatora wyrażeń języka C++. Wynik zostanie wyświetlony w oknie Polecenie debugera. Jeśli zaznaczony tekst zawiera więcej niż jedną linię, wystąpi błąd składni. To polecenie jest równoważne użyciu funkcji Edytuj | Oceń zaznaczenie polecenia, naciskając CTRL+SHIFT+V lub używając ?? (Oceń wyrażenie C++) polecenie z zaznaczonym tekstem jako argumentem.

• Wyświetl wybrany typ wyświetla typ danych wybranego obiektu. To wyświetlanie pojawia się w oknie poleceń debugera. Jeśli zaznaczony tekst zawiera więcej niż jeden obiekt, może zostać wyświetlony błąd składniowy lub inne nieregularne wyniki. To polecenie jest równoważne użyciu funkcji Edytuj | Wyświetl polecenie Wybranego typu lub naciśnij CTRL+SHIFT+Y.

• Otwarte okno pamięci dla zaznaczenia otwiera nowe zadokowane okno Pamięci, w ramach którego jest wyświetlana pamięć rozpoczynająca się od adresu wybranego wyrażenia.

• Dodaj zaznaczenie do okna Obserwowanie dodaje wybrany token źródłowy do okna obserwacji.

• Dezasembluj bieżący wiersz powoduje, że instrukcja odpowiadająca bieżącemu wierszowi pojawia się w oknie dezasemblacji. Wybrany wiersz jest wyróżniony w oknie Źródło i w oknie Dezasemblacja, ale to polecenie wpływa tylko na wyświetlanie — wskaźnik instrukcji nie zostanie zmieniony. Jeśli okno Dezasemblacji jest zamknięte po wybraniu tego polecenia, zostanie otwarte.

• Wybierz język źródłowy wyświetla listę języków programowania. Wybierz język programowania użyty do wygenerowania pliku źródłowego, a następnie wybierz przycisk OK , aby włączyć podstawowe wyróżnianie składni dla bieżącego okna Źródło. Wybierz <Brak>, aby wyłączyć podświetlanie składni w bieżącym oknie Źródło.

Kolory okna źródłowego i ocena efektów najechania myszą

Jeśli debuger rozpozna rozszerzenie nazwy pliku źródłowego, w oknie Źródło zostaną wyświetlone pewne elementy składni w kolorze. Aby wyłączyć lub zmienić kolory, wykonaj następujące czynności:

• Aby wyłączyć kolory składni w jednym oknie, otwórz menu skrótów okna Źródłowe, wybierz pozycję Wybierz język źródłowy, a następnie wybierz pozycję <Brak>.

• Aby wyłączyć kolory składni dla wszystkich okien źródłowych, wybierz pozycję Opcje z menu Widok . Następnie wyczyść pole wyboru Przeanalizuj języki źródłowe .

• Aby zmienić kolory składni, wybierz pozycję Opcje z menu Widok . Następnie w obszarze Kolory wybierz element składni i wybierz przycisk Zmień , aby zmienić kolor.

• Metoda analizowania używana do wyróżniania jest określana przez język programowania skojarzony z rozszerzeniem pliku źródłowego. Aby zmienić język programowania skojarzony z określonym rozszerzeniem pliku, użyj okna dialogowego Rozszerzenia plików dla języków źródłowych. Aby otworzyć to okno dialogowe, wybierz pozycję Rozszerzenia plików języka źródłowego z menu Widok .

Wyróżniony jest wiersz reprezentujący bieżący licznik programu. Linie, w których ustawiono punkty przerwania, są również wyróżnione.

Jeśli wybierzesz okno źródło, a następnie najedziesz myszą na symbol w tym oknie, symbol zostanie oceniony. Ocena jest taka sama jak wartość wygenerowana przez polecenie dt (Typ wyświetlania). Aby dezaktywować tę ocenę, wybierz pozycję Opcje z menu Widok . Następnie wyczyść pole wyboru Oceń po umieszczeniu wskaźnika myszy .

Zobacz także

Aby uzyskać więcej informacji na temat debugowania źródłowego i powiązanych poleceń, zobacz Debugowanie w trybie źródłowym.