Ścieżka kodu źródłowego

Ścieżka źródłowa określa katalogi, w których znajdują się pliki źródłowe C i C++.

Jeśli debugujesz proces trybu użytkownika na komputerze, na którym został skompilowany plik wykonywalny, a pliki źródłowe są nadal w ich oryginalnej lokalizacji, debuger może automatycznie zlokalizować pliki źródłowe.

W większości innych sytuacji należy ustawić ścieżkę źródłową lub załadować poszczególne pliki źródłowe.

Podczas zdalnego debugowania za pośrednictwem debugera serwer debugowania używa ścieżki źródłowej. Jeśli używasz narzędzia WinDbg jako debugera, każdy klient debugowania ma również własną lokalną ścieżkę źródłową. Wszystkie polecenia związane ze źródłem uzyskują dostęp do plików źródłowych na komputerze lokalnym. Należy ustawić odpowiednie ścieżki na dowolnym kliencie lub serwerze, który ma używać poleceń źródłowych.

Ten system wielościeżkowy umożliwia także klientowi debugującemu używanie poleceń związanych ze źródłem bez faktycznego dzielenia się plikami źródłowymi z innymi klientami lub serwerem. Ten system jest przydatny, jeśli istnieją prywatne lub poufne pliki źródłowe, do których jeden z użytkowników ma dostęp.

Pliki źródłowe można również ładować w dowolnym momencie, niezależnie od ścieżki źródłowej.

Składnia ścieżki źródłowej

Ścieżka źródłowa debugera jest ciągiem składającym się z wielu ścieżek katalogu oddzielonych średnikami.

Ścieżki względne są obsługiwane. Jednak jeśli nie zawsze uruchamiasz debuger z tego samego katalogu, powinieneś dodać literę dysku lub udział sieciowy przed każdą ścieżką. Obsługiwane są również udziały sieciowe.

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. Serwer źródłowy można użyć za pomocą 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.

Kontrolowanie ścieżki źródłowej

Aby kontrolować ścieżkę źródłową i lokalną ścieżkę źródłową, możesz wykonać jedną z następujących czynności:

• Przed rozpoczęciem debugera użyj zmiennej środowiskowej _NT_SOURCE_PATH, aby ustawić ścieżkę źródłową. Jeśli spróbujesz dodać nieprawidłowy katalog za pomocą tej zmiennej środowiskowej, debuger ignoruje ten katalog.

• Po uruchomieniu debugera użyj opcji wiersza polecenia -srcpath, aby ustawić ścieżkę źródłową.

• Użyj polecenia .srcpath (Ustaw ścieżkę źródłową), aby wyświetlić, ustawić, zmienić lub dołączyć do ścieżki źródłowej. Jeśli używasz serwera źródeł, srcfix (Użycie serwera źródłowego) jest nieco łatwiejsze.

• (Tylko WinDbg) Użyj polecenia lsrcpath (Ustaw lokalną ścieżkę źródłową), aby wyświetlić, ustawić, zmienić lub dołączyć do lokalnej ścieżki źródłowej. Jeśli używasz serwera źródłowego, plik lsrcfix (Użyj lokalnego serwera źródłowego) jest nieco łatwiejszy. Można również użyć WinDbg Command-Line z parametrem -lscrpath. Aby uzyskać więcej informacji, zobacz Opcje Command-Line WinDbg.

• (Tylko WinDbg) Użyj [File | Source File Path] lub naciśnij CTRL+P, aby wyświetlić, ustawić, zmienić lub dołączyć do ścieżki źródłowej lub lokalnej ścieżki źródłowej.

Możesz również bezpośrednio otworzyć lub zamknąć plik źródłowy, wykonując jedną z następujących czynności:

• Użyj polecenia lsf (załaduj lub zwolnij plik źródłowy), aby otworzyć lub zamknąć plik źródłowy.

• (Tylko WinDbg) Użyj polecenia open (open source file), aby otworzyć plik źródłowy.

• (Tylko WinDbg) Użyj polecenia plik | otwórz plik źródłowy lub naciśnij Ctrl+O, aby otworzyć plik źródłowy. Możesz również użyć przycisku open source (ctrl+o) na pasku narzędzi.

  Uwaga W przypadku korzystania z Plik | Otwórz plik źródłowy (lub jego odpowiedni element w menu lub przycisk) aby otworzyć plik źródłowy, ścieżka tego pliku jest automatycznie dołączana do ścieżki źródłowej.

• (Tylko WinDbg) Użyj polecenia File | Recent Files, aby otworzyć jeden z czterech ostatnio otwartych plików źródłowych w WinDbg.

• (Tylko WinDbg) Użyj polecenia Plik | Zamknij bieżące okno lub wybierz przycisk Zamknij w rogu okna źródłowego, aby zamknąć plik źródłowy.

Zobacz także

Aby uzyskać więcej informacji na temat używania plików źródłowych, zobacz Debugowanie w trybie źródłowym.