Zdalne debugowanie projektu C++ w programie Visual Studio

Aby debugować aplikację programu Visual Studio na innym komputerze, zainstaluj i uruchom narzędzia zdalne na komputerze, na którym wdrożysz aplikację, skonfiguruj projekt w celu nawiązania połączenia z komputerem zdalnym z programu Visual Studio, a następnie wdróż i uruchom aplikację.

Aby uzyskać informacje na temat zdalnego debugowania aplikacji uniwersalnych systemu Windows (UWP), zobacz Debugowanie zainstalowanego pakietu aplikacji.

Wymagania

Zdalny debuger jest obsługiwany w systemie Windows 7 i nowszych wersjach systemu Windows Server, począwszy od systemu Windows Server 2008 z dodatkiem Service Pack 2. Aby uzyskać pełną listę wymagań, zobacz Wymagania.

Uwaga

Debugowanie między dwoma komputerami połączonymi za pośrednictwem serwera proxy nie jest obsługiwane. Debugowanie przez duże opóźnienie lub połączenie o niskiej przepustowości, takie jak połączenie z Internetem lub za pośrednictwem Internetu w różnych krajach/regionach, nie jest zalecane i może zakończyć się niepowodzeniem lub niedopuszczalnie wolnym działaniem.

Pobieranie i instalowanie narzędzi zdalnych

Na urządzeniu zdalnym lub serwerze, na którym chcesz debugować, a nie na maszynie programu Visual Studio, pobierz i zainstaluj poprawną wersję narzędzi zdalnych z linków w poniższej tabeli.

• Pobierz najnowsze narzędzia zdalne dla używanej wersji programu Visual Studio. Najnowsza wersja narzędzi zdalnych jest zgodna z wcześniejszymi wersjami programu Visual Studio, ale wcześniejsze wersje narzędzi zdalnych nie są zgodne z nowszymi wersjami programu Visual Studio. (Jeśli na przykład używasz programu Visual Studio 2019, pobierz najnowszą aktualizację narzędzi zdalnych dla programu Visual Studio 2019. W tym scenariuszu nie pobieraj narzędzi zdalnych dla programu Visual Studio 2022).
• Pobierz narzędzia zdalne z tą samą architekturą co maszyna, na której je instalujesz. Jeśli na przykład chcesz debugować 32-bitową aplikację na komputerze zdalnym z systemem operacyjnym 64-bitowym, zainstaluj 64-bitowe narzędzia zdalne.
• Jeśli debugujesz zdalnie aplikację ARM64EC na urządzeniu ARM64, zainstaluj narzędzia zdalne ARM64, a następnie uruchom zdalny debuger x64 instalowany przy użyciu tych narzędzi. Można je znaleźć w obszarze: Program Files (x86)\Microsoft Visual Studio<version>\Common7\IDE\Remote Debugger\x64.

Wersja	Link	Uwagi
Visual Studio 2022	Narzędzia zdalne	Zgodność ze wszystkimi wersjami programu Visual Studio 2022. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 lub ARM64). W starszych wersjach systemu Windows Server zobacz Odblokowywanie pobierania pliku, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2019	Narzędzia zdalne	Zgodność ze wszystkimi wersjami programu Visual Studio 2019. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 lub ARM64). W starszych wersjach systemu Windows Server zobacz Odblokowywanie pobierania pliku, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2017	Narzędzia zdalne	Zgodność ze wszystkimi wersjami programu Visual Studio 2017. Pobierz wersję zgodną z systemem operacyjnym urządzenia (x86, x64 lub ARM64). W systemie Windows Server zobacz Odblokowywanie pobierania plików, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2015	Narzędzia zdalne	Narzędzia zdalne dla programu Visual Studio 2015 są dostępne w My.VisualStudio.com. Jeśli zostanie wyświetlony monit, dołącz do bezpłatnego programu Visual Studio Dev Essentials lub zaloguj się przy użyciu identyfikatora subskrypcji programu Visual Studio. W systemie Windows Server zobacz Odblokowywanie pobierania plików, aby uzyskać pomoc dotyczącą pobierania narzędzi zdalnych.
Visual Studio 2013	Narzędzia zdalne	Strona pobierania w dokumentacji programu Visual Studio 2013
Visual Studio 2012	Narzędzia zdalne	Strona pobierania w dokumentacji programu Visual Studio 2012

Debuger zdalny można uruchomić, kopiując msvsmon.exe na komputer zdalny, zamiast instalować narzędzia zdalne. Jednak Kreator konfiguracji debugera zdalnego (rdbgwiz.exe) jest dostępny tylko podczas instalowania narzędzi zdalnych. Może być konieczne użycie kreatora do konfiguracji, jeśli chcesz uruchomić zdalny debuger jako usługę. Aby uzyskać więcej informacji, zobacz (Opcjonalnie) Konfigurowanie zdalnego debugera jako usługi.

Uwaga

• Aby debugować aplikacje systemu Windows 10 lub nowsze na urządzeniach ARM, użyj usługi ARM64, która jest dostępna z najnowszą wersją narzędzi zdalnych.
• Aby debugować aplikacje systemu Windows 10 na urządzeniach z systemem Windows RT, użyj usługi ARM, która jest dostępna tylko w pobraniu narzędzi zdalnych programu Visual Studio 2015.

Napiwek

W niektórych scenariuszach najbardziej wydajne może być uruchamianie zdalnego debugera z udziału plików. Aby uzyskać więcej informacji, zobacz Uruchamianie zdalnego debugera z udziału plików.

Konfigurowanie zdalnego debugera

1. Na komputerze zdalnym znajdź i uruchom debuger zdalny z menu Start .

   Jeśli nie masz uprawnień administracyjnych na komputerze zdalnym, kliknij prawym przyciskiem myszy aplikację Remote Debugger i wybierz polecenie Uruchom jako administrator. W przeciwnym razie po prostu uruchom go normalnie.

   Jeśli planujesz dołączyć do procesu, który jest uruchomiony jako administrator lub działa w ramach innego konta użytkownika (takiego jak usługi IIS), kliknij prawym przyciskiem myszy aplikację Remote Debugger i wybierz polecenie Uruchom jako administrator. Aby uzyskać więcej informacji, zobacz Uruchamianie zdalnego debugera jako administrator.

2. Przy pierwszym uruchomieniu debugera zdalnego (lub przed jego skonfigurowaniem) zostanie wyświetlony kreator Konfiguracja debugowania zdalnego.

   W większości scenariuszy wybierz pozycję Dalej , dopóki nie zostanie wyświetlona strona Konfigurowanie Zapory systemu Windows kreatora.

   

3. Wybierz co najmniej jeden typ sieci, w którym chcesz używać narzędzi zdalnych. Jeśli komputery są połączone za pośrednictwem domeny, musisz wybrać pierwszy element. Jeśli komputery są połączone za pośrednictwem grupy roboczej lub grupy domowej, wybierz odpowiedni drugi lub trzeci element.

   Następnie wybierz pozycję Zakończ , aby uruchomić debuger zdalny.

4. Po zakończeniu konfiguracji zostanie wyświetlone okno Debuger zdalny.

   

   Zdalny debuger czeka teraz na połączenie. Użyj nazwy serwera i podanego numeru portu, aby ustawić konfigurację połączenia zdalnego w programie Visual Studio.

Aby zatrzymać zdalny debuger, wybierz pozycję Plik>Zakończ. Można go ponownie uruchomić z menu Start lub z poziomu wiersza polecenia:

<Remote debugger installation directory>\msvsmon.exe

Uwaga

Jeśli musisz dodać uprawnienia dla dodatkowych użytkowników, zmienić tryb uwierzytelniania lub numer portu debugera zdalnego, zobacz Konfigurowanie zdalnego debugera.

Debugowanie zdalne projektu C++

W poniższej procedurze ścieżka projektu to C:\remotetemp, a nazwa komputera zdalnego to MySurface.

1. Tworzenie aplikacji konsolowej C++ o nazwie CppConsoleApp

2. Ustaw punkt przerwania gdzieś w aplikacji, która jest łatwo osiągana, na przykład w CppConsoleApp.cpp w main funkcji.

3. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt i wybierz polecenie Właściwości. Otwórz kartę Debugowanie .

4. Ustaw debuger , aby uruchomić polecenie Remote Windows Debugger.

   

5. Wprowadź następujące zmiany we właściwościach:

   Ustawienie	Wartość
   Zdalne polecenie	C:\remotetemp\CppConsoleApp.exe
   Katalog roboczy	C:\remotetemp
   Nazwa serwera zdalnego	MySurface:portnumber
   Connection	Zdalne z uwierzytelnianiem systemu Windows
   Typ debugera	Tylko natywne
   Katalog wdrażania	C:\remotetemp
   Dodatkowe pliki do wdrożenia	$(ProjectDir)\data

   Jeśli wdrażasz dodatkowe foldery i chcesz, aby wszystkie pliki w folderze zostały wdrożone w tym samym folderze, określ nazwę folderu.

   Aby uzyskać więcej informacji na temat właściwości, zobacz Project settings for a C++ Debug configuration (Ustawienia projektu dla konfiguracji debugowania języka C++).

6. W Eksplorator rozwiązań kliknij rozwiązanie prawym przyciskiem myszy i wybierz pozycję Configuration Manager.

7. W obszarze Konfiguracja debugowania zaznacz pole wyboru Wdróż .

   

8. Rozpocznij debugowanie (Debugowanie > rozpocznij debugowanie lub F5).

9. Plik wykonywalny jest wdrażany automatycznie na komputerze zdalnym.

10. Jeśli zostanie wyświetlony monit, wprowadź poświadczenia sieciowe, aby nawiązać połączenie z maszyną zdalną.

    Wymagane poświadczenia są specyficzne dla konfiguracji zabezpieczeń sieci. Na przykład na komputerze domeny można wybrać certyfikat zabezpieczeń lub wprowadzić nazwę domeny i hasło. Na maszynie innej niż domena możesz wprowadzić nazwę komputera i prawidłową nazwę konta użytkownika, taką jak MySurface\name@something.com, wraz z poprawnym hasłem.

11. Na komputerze programu Visual Studio powinno być widoczne, że wykonywanie jest zatrzymane w punkcie przerwania.

    Napiwek

    Alternatywnie możesz wdrożyć pliki jako oddzielny krok. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł projektu, a następnie wybierz polecenie Wdróż.

    Jeśli masz pliki inne niż kod wymagane przez aplikację, możesz określić je na liście rozdzielanej średnikami na stronie Dodatkowe pliki do wdrożenia na stronie zdalnego debugera systemu Windows.

    Alternatywnie możesz uwzględnić pliki w projekcie i ustawić właściwość Content na wartość Tak na stronie Właściwości dla każdego pliku. Te pliki są kopiowane do katalogu wdrażania określonego na stronie zdalnego debugera systemu Windows. Możesz również zmienić typ elementu na Kopiuj plik i określić w nim dodatkowe właściwości, jeśli chcesz skopiować pliki do podfolderu katalogu wdrożenia.

Konfigurowanie debugowania za pomocą symboli zdalnych

Powinno być możliwe debugowanie kodu za pomocą symboli wygenerowanych na komputerze programu Visual Studio. Wydajność zdalnego debugera jest znacznie lepsza w przypadku używania symboli lokalnych.

Jeśli musisz użyć symboli zdalnych, musisz określić symbole zdalne w programie Visual Studio, dodając udział plików systemu Windows do ścieżki wyszukiwania symboli w obszarze Narzędzia > Opcje > Symbole debugowania>.

Powiązana zawartość

• Debugowanie w programie Visual Studio
• Pierwsze spojrzenie na debugera
• Konfigurowanie zapory systemu Windows na potrzeby debugowania zdalnego
• Remote Debugger Port Assignments (Przypisania portów zdalnego debugera)
• Zdalne debugowanie platformy ASP.NET na komputerze zdalnym usług IIS
• Błędy związane z debugowaniem zdalnym i rozwiązywanie problemów