Dołączanie do uruchomionych procesów za pomocą debugera programu Visual Studio

Debuger programu Visual Studio można dołączyć do uruchomionego procesu na komputerze lokalnym lub zdalnym. Po uruchomieniu procesu wybierz pozycję Dołącz debugowanie>do procesu lub naciśnij Ctrl+Alt+p w programie Visual Studio i użyj okna dialogowego Dołączanie do procesu , aby dołączyć debuger do procesu.

Możesz użyć Dołącz do procesu, aby debugować uruchomione aplikacje na komputerach lokalnych lub zdalnych, debugować wiele procesów jednocześnie, debugować aplikacje, które nie zostały utworzone w programie Visual Studio, lub debugować dowolną aplikację, której nie uruchomiłeś z poziomu programu Visual Studio z dołączonym debugerem. Jeśli na przykład używasz aplikacji bez debugera i napotkasz wyjątek, możesz dołączyć debuger do procesu uruchamiania aplikacji i rozpocząć debugowanie.

Wskazówka

Nie wiesz, czy używać opcji Dołączanie do procesu na potrzeby scenariusza debugowania? Zobacz Typowe scenariusze debugowania.

Dołączanie do uruchomionego procesu na komputerze lokalnym

Aby szybko ponownie dołączyć do dołączonego wcześniej procesu, zobacz Ponowne dołączanie do procesu.

Począwszy od programu Visual Studio 2022 w wersji 17.10 (wersja zapoznawcza 2), okno dialogowe Dołączanie do procesu zostało zmienione. Jeśli potrzebujesz instrukcji pasujących do starszego okna dialogowego, przejdź do widoku programu Visual Studio 2019 (selektor wersji w lewym górnym rogu w artykule).

Aby dołączyć do procesu na komputerze lokalnym:

1. W programie Visual Studio wybierz Debug>Dołącz do procesu (lub naciśnij Ctrl+Alt+P), aby otworzyć okno dialogowe Dołącz do procesu.

2. Ustaw Typ połączenia na Lokalny.

   W większości lokalnych scenariuszy debugowania można użyć Local. Niektóre scenariusze mogą wymagać innego typu połączenia. Aby uzyskać więcej informacji, zobacz inne sekcje w tym artykule lub Typowe scenariusze debugowania.

   

3. Na liście Dostępne procesy znajdź i wybierz proces lub procesy, do których chcesz dołączyć.

   • Aby szybko wybrać proces, wpisz jego nazwę lub pierwszą literę w polu Procesy filtrowania .
   • Jeśli nie znasz nazwy procesu, przejrzyj listę lub zobacz Typowe scenariusze debugowania dla niektórych typowych nazw procesów.
   • Użyj przycisku Śledź okno , aby włączyć wybieranie okna na komputerze, które ustawia proces.

   Wskazówka

   Procesy mogą być uruchamiane i zatrzymywane w tle, gdy okno dialogowe Dołączanie do procesu jest otwarte, więc lista uruchomionych procesów może nie zawsze być aktualna. Możesz wybrać pozycję Odśwież w dowolnym momencie, aby wyświetlić bieżącą listę.

4. W polu Typ kodu upewnij się, że na liście znajduje się typ kodu, który planujesz debugować.

   Domyślne ustawienie Automatyczne działa dla większości typów aplikacji, ale można wybrać określony typ kodu, aby ręcznie określić typ debugera.

5. Wybierz Dołącz.

Wskazówka

W scenariuszu, w którym masz wiele identycznych procesów, użyj kolumny „Command Line” lub szczegółów procesu w3wp z kolumny „Title”, aby zidentyfikować właściwy proces.

Uwaga / Notatka

Można dołączyć do wielu aplikacji do debugowania, ale tylko jedna aplikacja jest aktywna w debugerze jednocześnie. Aktywną aplikację można ustawić na pasku narzędzi Lokalizacja debugowania programu Visual Studio lub w oknie Procesy .

Dołącz do procesu na komputerze zdalnym

Możesz również wybrać komputer zdalny w oknie dialogowym Dołączanie do procesu , wyświetlić listę dostępnych procesów uruchomionych na tym komputerze i dołączyć do co najmniej jednego procesu do debugowania. Zdalny debuger (msvsmon.exe) musi być uruchomiony na komputerze zdalnym. Aby uzyskać więcej informacji, zobacz Debugowanie zdalne.

Począwszy od programu Visual Studio 2022 w wersji 17.10 (wersja zapoznawcza 2), okno dialogowe Dołączanie do procesu zostało zmienione. Jeśli potrzebujesz instrukcji pasujących do starszego okna dialogowego, przejdź do widoku programu Visual Studio 2019 (selektor wersji w lewym górnym rogu w artykule).

Aby dołączyć do uruchomionego procesu na komputerze zdalnym:

1. W programie Visual Studio wybierz pozycję Dołącz do procesu (lub naciśnij Ctrl+Alt+P), aby otworzyć okno dialogowe Dołącz do procesu.

2. Ustaw typ połączenia na typ połączenia zdalnego, taki jak Remote (Windows).

   W większości scenariuszy zdalnego debugowania w systemie Windows można użyć Remote (Windows). Niektóre scenariusze, takie jak debugowanie systemu Linux lub aplikacji konteneryzowanej, wymagają innego typu połączenia. Aby uzyskać więcej informacji, zobacz inne sekcje w tym artykule lub Typowe scenariusze debugowania.

   Zostanie wyświetlona opcja Cel połączenia .

3. W polu Obiekt docelowy połączenia wybierz komputer zdalny przy użyciu jednej z następujących metod:

   • Wybierz strzałkę listy rozwijanej obok pozycji Cel połączenia i wybierz nazwę komputera z listy rozwijanej.
   • Wpisz nazwę komputera w polu Obiekt docelowy połączenia i naciśnij Enter.
   • Wybierz przycisk Znajdź obok pola Cel połączenia , aby otworzyć okno dialogowe Połączenia zdalne . Okno dialogowe Połączenia zdalne zawiera listę wszystkich urządzeń, które znajdują się w podsieci lokalnej lub bezpośrednio dołączone do komputera. Może być konieczne otwarcie wychodzącego portu UDP 3702 na serwerze w celu odnalezienia urządzeń zdalnych. Wybierz odpowiedni komputer lub urządzenie, a następnie zamknij okno dialogowe.

   Sprawdź, czy program Visual Studio dodaje wymagany port do nazwy komputera, która jest wyświetlana w formacie: <nazwa komputera zdalnego>:port

   Uwaga / Notatka

   Jeśli nie możesz nawiązać połączenia przy użyciu nazwy komputera zdalnego, spróbuj użyć adresu IP i adresu portu (na przykład 123.45.678.9:4026). 4026 to domyślny port zdalnego debugera programu Visual Studio 2022. Aby uzyskać informacje na temat innych przypisań portów debugera zdalnego, zobacz Remote debugger port assignments (Przypisania portów debugera zdalnego).

   Ustawienie Typ połączenia jest utrwalane między sesjami debugowania. Ustawienie Cel połączenia utrzymuje się między sesjami debugowania tylko wtedy, gdy nastąpiło pomyślne debugowanie połączenia z tym obiektem docelowym.

4. Kliknij przycisk Odśwież , aby wypełnić listę Dostępne procesy .

   Wskazówka

   Procesy mogą być uruchamiane i zatrzymywane w tle, gdy okno dialogowe Dołączanie do procesu jest otwarte, więc lista uruchomionych procesów może nie zawsze być aktualna. Możesz wybrać pozycję Odśwież w dowolnym momencie, aby wyświetlić bieżącą listę.

5. Na liście Dostępne procesy znajdź i wybierz proces lub procesy, do których chcesz dołączyć.

   • Aby szybko wybrać proces, wpisz jego nazwę lub pierwszą literę w polu wyszukiwania procesów.

   • Jeśli nie znasz nazwy procesu, przejrzyj listę lub zobacz Typowe scenariusze debugowania dla niektórych typowych nazw procesów.

   • Aby znaleźć procesy uruchomione na wszystkich kontach użytkowników, zaznacz pole wyboru Pokaż procesy ze wszystkich użytkowników .

     Uwaga / Notatka

     Jeśli spróbujesz dołączyć do procesu należącego do niezaufanego konta użytkownika, zostanie wyświetlone okno dialogowe ostrzeżenia o zabezpieczeniach. Aby uzyskać więcej informacji, zobacz Ostrzeżenie o zabezpieczeniach: dołączanie do procesu należącego do niezaufanego użytkownika może być niebezpieczne. Jeśli poniższe informacje wyglądają podejrzanie lub nie masz pewności, nie dołączaj do tego procesu.

6. W polu Typ kodu upewnij się, że na liście znajduje się typ kodu, który planujesz debugować.

   Domyślne ustawienie Automatyczne działa dla większości typów aplikacji, ale można wybrać określony typ kodu, aby ręcznie określić typ debugera.

7. Wybierz Dołącz.

Uwaga / Notatka

Można dołączyć do wielu aplikacji do debugowania, ale tylko jedna aplikacja jest aktywna w debugerze jednocześnie. Aktywną aplikację można ustawić na pasku narzędzi Lokalizacja debugowania programu Visual Studio lub w oknie Procesy .

W niektórych przypadkach podczas debugowania w sesji usług pulpitu zdalnego (usług terminalowych) lista Dostępnych procesów nie będzie wyświetlać wszystkich dostępnych procesów. Jeśli używasz programu Visual Studio jako użytkownika z ograniczonym kontem użytkownika, lista Dostępne procesy nie będzie zawierać procesów uruchomionych w sesji 0. Sesja 0 jest używana dla usług i innych procesów serwera, w tym w3wp.exe. Problem można rozwiązać, uruchamiając program Visual Studio na koncie administratora lub uruchamiając program Visual Studio z konsoli serwera zamiast sesji pulpitu zdalnego.

Jeśli żadne z tych obejść nie jest możliwe, trzecią opcją jest dołączenie do procesu przez uruchomienie vsjitdebugger.exe -p <ProcessId> z wiersza polecenia systemu Windows. Identyfikator procesu można określić przy użyciu tlist.exe. Aby uzyskać tlist.exe, pobierz i zainstaluj narzędzia debugowania dla systemu Windows, dostępne w plikach WDK i WinDbg do pobrania.

Dołączanie do procesu platformy .NET Core uruchomionego w usłudze Azure App Service (Windows)

Jeśli publikujesz w usłudze Azure App Service (Windows), zobacz Zdalne debugowanie ASP.NET Core na platformie Azure lub Debugowanie usługi Azure App Service , aby uzyskać instrukcje.

Dołączanie do procesu platformy .NET Core uruchomionego w systemie Linux przy użyciu protokołu SSH

Aby uzyskać więcej informacji, zobacz Remote debug .NET Core running on Linux using SSH (Zdalne debugowanie platformy .NET Core działające w systemie Linux przy użyciu protokołu SSH).

Dołączanie do procesu uruchomionego w kontenerze platformy Docker

Począwszy od programu Visual Studio 2019, można dołączyć debuger programu Visual Studio do procesu uruchomionego w kontenerze platformy Docker. W przypadku kontenera Linux Docker .NET Core, zobacz Dołączanie do procesu uruchomionego w kontenerze Docker na Linuxie. Aby uzyskać informacje na temat kontenera Docker w systemie Windows, sprawdź Dołącz do procesu uruchomionego w kontenerze Docker w systemie Windows.

Ponowne dołączenie do procesu

Możesz szybko przyłączyć się ponownie do procesów, do których byłeś wcześniej przyłączony, wybierając pozycję Debuguj>Przyłącz ponownie do procesu (Shift+Alt+P). Po wybraniu tego polecenia debuger natychmiast spróbuje dołączyć do ostatnich procesów, próbując najpierw dopasować poprzedni identyfikator procesu, a jeśli to się nie powiedzie, dopasować poprzednią nazwę procesu. Jeśli nie znaleziono dopasowań lub jeśli kilka procesów ma taką samą nazwę, zostanie otwarte okno dialogowe Dołączanie do procesu , aby można było wybrać prawidłowy proces.

Uwaga / Notatka

Polecenie Dołącz ponownie do procesu jest dostępne od programu Visual Studio 2017.

Typowe scenariusze debugowania

Aby ułatwić określenie, czy należy używać funkcji Dołączanie do procesu i do jakiego procesu należy dołączyć, w poniższej tabeli przedstawiono kilka typowych scenariuszy debugowania z linkami do dodatkowych instrukcji, jeśli są dostępne. (Lista nie jest wyczerpująca).

Aby szybko wybrać uruchomiony proces do dołączenia, w programie Visual Studio wpisz Ctrl+Alt+P, a następnie wpisz pierwszą literę nazwy procesu.

Aby debuger dołączył do kodu napisanego w języku C++, kod musi emitować DebuggableAttribute. Możesz dodać to do kodu automatycznie, linkując z opcją linker /ASSEMBLYDEBUG.

W przypadku debugowania skryptu po stronie klienta debugowanie skryptu musi być włączone w przeglądarce. Aby debugować skrypt po stronie klienta w przeglądarce Chrome, wybierz pozycję JavaScript lub TypeScript jako typ kodu, a w zależności od typu aplikacji może być konieczne zamknięcie wszystkich wystąpień przeglądarki Chrome i uruchomienie przeglądarki w trybie debugowania (wpisz z chrome.exe --remote-debugging-port=9222 wiersza polecenia).

Scenario	Metoda debugowania	Nazwa procesu	Notatki i linki
ASP.NET Core — zdalne debugowanie na serwerze internetowych usług informacyjnych (IIS)	Korzystanie z narzędzi zdalnych i dołączanie do procesu	w3wp.exe lub dotnet.exe	Począwszy od platformy .NET Core 3, proces w3wp.exe jest używany dla domyślnego modelu hostingu w aplikacji. Aby zapoznać się z wdrażaniem aplikacji, zobacz Publikowanie w usługach IIS. Aby uzyskać bardziej szczegółowe informacje, zobacz Zdalne debugowanie ASP.NET Core na zdalnym serwerze IIS
ASP.NET Core — debugowanie na komputerze lokalnym po uruchomieniu aplikacji bez debugera	Użyj Dołącz do procesu	appname.exe lub iisexpress.exe	Może to być przydatne, aby przyspieszyć ładowanie aplikacji, np. (na przykład) podczas profilowania. Domyślny proces serwera lokalnego (kestrel) dla ASP.NET Core to appname.exe.
ASP.NET 4 lub 4.5 — zdalne debugowanie na serwerze usług IIS	Korzystanie z narzędzi zdalnych i dołączanie do procesu	w3wp.exe	Zobacz Zdalne debugowanie ASP.NET na zdalnym komputerze IIS
Skrypt po stronie klienta — debugowanie na lokalnym serwerze IIS dla obsługiwanych typów aplikacji	Użyj Dołącz do procesu	chrome.exe lub msedge.exe	Debugowanie skryptu musi być włączone. W przeglądarce Chrome należy również uruchomić przeglądarkę Chrome w trybie debugowania (wpisz chrome.exe --remote-debugging-port=9222 z wiersza polecenia) i wybrać język JavaScript lub TypeScript w polu Dołącz do .
Aplikacja C#, Visual Basic lub C++ — debugowanie na komputerze lokalnym	Użyj standardowego debugowania (F5) lub Dołącz do procesu	{appname}.exe	W większości scenariuszy należy używać standardowego debugowania, a nie dołączania do procesu.
Aplikacja klasyczna systemu Windows — debugowanie zdalne	Narzędzia zdalne	N/A	Zobacz Zdalne debugowanie aplikacji w C# lub Visual Basic lub zdalne debugowanie aplikacji w C++
.NET Core w systemie Linux — debugowanie	Użyj Dołącz do procesu	dotnet.exe lub unikatową nazwę procesu	Aby użyć protokołu SSH, zobacz Zdalne debugowanie platformy .NET Core działającej w systemie Linux przy użyciu protokołu SSH. W przypadku aplikacji konteneryzowanych zobacz Dołączanie do procesu uruchomionego w kontenerze platformy Docker.
Konteneryzowana aplikacja — debugowanie	Użyj Dołącz do procesu	dotnet.exe lub unikatową nazwę procesu	Zobacz Dołączanie do procesu uruchomionego w kontenerze platformy Docker
Python w systemie Linux — debugowanie zdalne	Użyj dołączenia do procesu	debugpy	Zobacz Dołączanie zdalnie z poziomu narzędzi języka Python
Inne obsługiwane typy aplikacji — debugowanie w procesie serwera	Jeśli serwer jest zdalny, użyj narzędzi zdalnych i dołącz do procesu	chrome.exe, msedge.exe, lub innych procesów	W razie potrzeby użyj monitora zasobów, aby zidentyfikować proces. Zobacz Debugowanie zdalne.
Aplikacja platformy uniwersalnej systemu Windows (UWP), onecore, HoloLens lub aplikacja IoT — debugowanie zdalne	Debugowanie zainstalowanego pakietu aplikacji	N/A	Zobacz Debugowanie zainstalowanego pakietu aplikacji zamiast używania Dołącz do procesu
Aplikacja UWP, OneCore, HoloLens lub IoT — debugowanie aplikacji niewystartowanej z programu Visual Studio	Debugowanie zainstalowanego pakietu aplikacji	N/A	Zobacz Debugowanie zainstalowanego pakietu aplikacji zamiast użycia Dołącz do procesu

Korzystanie z funkcji debugera

Aby użyć pełnych funkcji debugera programu Visual Studio (na przykład zatrzymywania się na punktach przerwania) podczas dołączania do procesu, aplikacja musi idealnie pasować do lokalnego źródła i symboli. Oznacza to, że debuger musi mieć możliwość załadowania poprawnych plików symboli (.pdb). Domyślnie wymaga to kompilacji debug.

W przypadku scenariuszy zdalnego debugowania musisz mieć już otwarty kod źródłowy (lub kopię kodu źródłowego) w programie Visual Studio. Skompilowane pliki binarne aplikacji na maszynie zdalnej muszą pochodzić z tej samej kompilacji co na komputerze lokalnym.

W niektórych lokalnych scenariuszach debugowania można debugować w programie Visual Studio bez dostępu do źródła, jeśli odpowiednie pliki symboli są obecne w aplikacji. Domyślnie wymaga to wersji do debugowania. Aby uzyskać więcej informacji, zobacz Określanie symboli i plików źródłowych.

Rozwiązywanie problemów z błędami dołączania

W niektórych scenariuszach debuger może potrzebować pomocy w prawidłowym zidentyfikowaniu typu kodu do debugowania. Jeśli wartości połączenia są ustawione poprawnie (możesz wyświetlić prawidłowy proces na liście Dostępne procesy ), ale debuger nie może dołączyć, spróbuj wybrać najbardziej odpowiedni debuger na liście Typ kodu , co może być wymagane, na przykład jeśli debugujesz aplikację systemu Linux lub Python.

Czasami debuger może pomyślnie dołączyć do jednego typu kodu, ale nie do innego. Zazwyczaj dzieje się tak, gdy:

• Próbujesz dołączyć do procesu uruchomionego na komputerze zdalnym. Komputer zdalny może mieć zainstalowane składniki zdalnego debugowania dla niektórych typów kodu, ale nie dla innych.
• Próbujesz dołączyć do co najmniej dwóch procesów na potrzeby bezpośredniego debugowania bazy danych. Debugowanie SQL obsługuje dołączanie tylko do pojedynczego procesu.

Jeśli debuger jest w stanie dołączyć do niektórych, ale nie wszystkich typów kodu, zostanie wyświetlony komunikat identyfikujący, które typy nie mogą zostać dołączone.

Jeśli debuger pomyślnie połączy się z co najmniej jednym typem kodu, możesz przystąpić do debugowania tej operacji. Będzie można debugować tylko typy kodu, które zostały pomyślnie dołączone. Nieprzyłączony kod w procesie będzie nadal uruchamiany, ale nie będzie można ustawić punktów przerwania, wyświetlić danych ani wykonać innych operacji debugowania na tym kodzie.

Jeśli chcesz uzyskać bardziej szczegółowe informacje o tym, dlaczego debuger nie może dołączyć do typu kodu, spróbuj ponownie dołączyć go tylko do tego typu kodu.

Uzyskanie szczegółowych informacji o tym, dlaczego typ kodu nie został dołączony

1. Odłącz się od procesu. W menu Debugowanie wybierz pozycję Odłącz wszystko.

2. Ponownie dołącz do procesu, wybierając tylko typ kodu, którego nie udało się dołączyć.

   1. W oknie dialogowym Dołączanie do procesu wybierz proces na liście Dostępne procesy .

   2. W opcji Typ kodu wybierz typ kodu, którego nie można dołączyć. Usuń zaznaczenie innych typów kodu.

   3. W oknie dialogowym Dołączanie do procesu wybierz pozycję Dołącz.

   Tym razem dołączanie zakończy się niepowodzeniem i zostanie wyświetlony określony komunikat o błędzie.

Treści powiązane

• Debugowanie wielu procesów
• Just-In-Time debugowanie
• debugowanie zdalne