Присоединение к выполняемым процессам с использованием отладчика Visual Studio
Область применения:
Visual Studio Visual Studio для Mac 
Visual Studio Code
Отладчик Visual Studio можно подключить к запущенному процессу на локальном или удаленном компьютере. После выполнения процесса выберите Отладка>Подключить к процессу или нажмите клавишиCTRL+ALT+P в Visual Studio и используйте диалоговое окно Подключение к процессу, чтобы подключить отладчик к процессу.
Параметр Подключить к процессу можно использовать для отладки запущенных приложений на локальных или удаленных компьютерах, одновременной отладки нескольких процессов, отладки приложений, которые не были созданы в Visual Studio, или отладки любого приложения, которое не было запущено из Visual Studio с прикрепленным отладчиком. Например, если вы используете приложение без отладчика и столкнулись с исключением, можно присоединить отладчик к процессу, в котором выполняется приложение, и начать отладку.
Не уверены, следует ли использовать параметр Подключить к процессу для сценария отладки? См. раздел Общие сценарии отладки.
Присоединение к запущенному процессу на локальном компьютере
Сведения о том, как быстро присоединиться к процессу, подключенному ранее, см. в разделе Повторное подключение к процессу.
Порядок присоединения к процессу на локальном компьютере
- В Visual Studio выберите Отладка>Подключить к процессу (или нажмите клавиши CTRL+ALT+P), чтобы открыть диалоговое окно Подключение к процессу.
- Проверьте значение параметра Тип подключения. В большинстве случаев можно использовать значение По умолчанию. Для некоторых сценариев может потребоваться другой тип подключения. Дополнительные сведения см. в других разделах этой статьи, а также в разделе Общие сценарии отладки.
- В поле Цель подключения укажите имя локального компьютера.
- Чтобы быстро выбрать процесс, введите его имя или первую букву в поле Фильтр процессов.
- Если вы не знаете имя процесса, просмотрите список или обратитесь к разделу Общие сценарии отладки, чтобы ознакомиться с некоторыми распространенными именами процессов.
Процессы могут запускаться и останавливаться в фоновом режиме, пока диалоговое окно Подключение к процессу открыто, поэтому список запущенных процессов может не всегда быть актуальным. Чтобы просмотреть актуальный список, можно в любое время нажать кнопку Обновить.
- Щелкните Выбрать.
- В диалоговом окне Выбор типа кода нажмите кнопку Выполнять отладку кода следующих типов. Если при попытке подключиться к процессу из списка возникает ошибка, можно воспользоваться диалоговым окном Выбор типа кода, чтобы устранить неполадку.
- Выберите типы кода, которые необходимо отладить.
- Нажмите ОК.
В сценарии с несколькими идентичными процессами вы можете указать процесс с использованием столбца командной строки или сведений о процессе w3wp из столбца заголовка.
Во время отладки можно подключиться к нескольким приложениям, но в любой момент времени только один из них активен в отладчике. Можно выбрать текущую программу в панели инструментов Место отладки или окне Процессы в Visual Studio.
Присоединение к процессу на удаленном компьютере
В диалоговом окне Подключение к процессу также можно выбрать удаленный компьютер, просмотреть список доступных процессов, запущенных на этом компьютере, и подключиться к одному или нескольким процессам для отладки. На удаленном компьютере должен выполняться удаленный отладчик (msvsmon.exe). Дополнительные сведения см. в статье Удаленная отладка.
Более полные инструкции по отладке приложений ASP.NET, развернутых в службах IIS, см. в разделе Удаленная отладка ASP.NET на удаленном компьютере IIS.
Присоединение к выполняющемуся процессу на удаленном компьютере
- В Visual Studio выберите Отладка>Подключить к процессу (или нажмите клавиши CTRL+ALT+P), чтобы открыть диалоговое окно Подключение к процессу.
- Проверьте значение параметра Тип подключения. В большинстве случаев можно использовать значение По умолчанию. В некоторых сценариях, таких как отладка Linux или контейнерного приложения, требуется другой тип подключения. Дополнительные сведения см. в других разделах этой статьи, а также в разделе Общие сценарии отладки.
- В поле Целевой объект подключения выберите удаленный компьютер одним из следующих способов.
- Щелкните стрелку раскрывающегося списка Целевой объект подключения и выберите из раскрывающегося списка имя компьютера.
- Введите имя компьютера в поле Целевой объект подключения и нажмите клавишу ВВОД. Убедитесь, что Visual Studio добавляет требуемый порт в имя компьютера, которое отображается в формате: :порт
Примечание. Если вы не можете подключиться с помощью имени удаленного компьютера, попробуйте использовать IP-адрес и порт (например, 123.45.678.9:4022 ). 4026 — это порт по умолчанию для удаленного отладчика Visual Studio 2022. Сведения о других назначениях портов удаленного отладчика см. в разделе Назначение портов удаленного отладчика.
Примечание. Если вы не можете подключиться с помощью имени удаленного компьютера, попробуйте использовать IP-адрес и порт (например, 123.45.678.9:4022 ). 4024 — это порт по умолчанию для удаленного отладчика Visual Studio 2019. Сведения о других назначениях портов удаленного отладчика см. в разделе Назначение портов удаленного отладчика.
Значение параметра Тип подключения сохраняется между сеансами отладки. Параметр Целевой объект подключения хранится между сеансами отладки только в случае успешного подключения отладки с этим целевым объектом.
Совет Процессы могут запускаться и останавливаться в фоновом режиме, пока диалоговое окно Подключение к процессу открыто, поэтому список запущенных процессов может не всегда быть актуальным. Чтобы просмотреть актуальный список, можно в любое время нажать кнопку Обновить.
- Чтобы быстро выбрать процесс, введите его имя или первую букву в поле Фильтр процессов.
- Если вы не знаете имя процесса, просмотрите список или обратитесь к разделу Общие сценарии отладки, чтобы ознакомиться с некоторыми распространенными именами процессов.
- Чтобы найти процесс, который выполняется с другой учетной записью пользователя, установите флажок Показать процессы всех пользователей.
Примечание. Если попытаться подключиться к процессу, работающему под управлением ненадежной учетной записи, появится диалоговое окно подтверждения с предупреждением безопасности. Дополнительные сведения см. в разделе предупреждение системы безопасности: Присоединение к процессу, принадлежит недоверенному пользователю может быть опасно. Если следующие сведения не вызывают доверия, то не следует присоединяться к процессу.
- Щелкните Выбрать.
- В диалоговом окне Выбор типа кода нажмите кнопку Выполнять отладку кода следующих типов. Если при попытке подключиться к процессу из списка возникает ошибка, можно воспользоваться диалоговым окном Выбор типа кода, чтобы устранить неполадку.
- Нажмите ОК.
Во время отладки можно подключиться к нескольким приложениям, но в любой момент времени только один из них активен в отладчике. Можно выбрать текущую программу в панели инструментов Место отладки или окне Процессы в Visual Studio.
В некоторых случаях при отладке в сеансе удаленного рабочего стола (службы терминалов) в списке Доступные процессы не отображаются все доступные процессы. При работе с Visual Studio в качестве пользователя с ограниченным доступом в списке Доступные процессы не будут отображаться процессы, запущенные в сеансе 0, который используется для служб и других серверных процессов, включая w3wp.exe. Можно разрешить эту проблему, запустив Visual Studio с учетной записью администратора или запустив Visual Studio с консоли сервера вместо сеанса служб терминалов.
Если ни один из этих обходных путей использовать невозможно, третий вариант — присоединение к процессу путем запуска vsjitdebugger.exe -p из командной строки Windows. Можно определить идентификатор процесса с помощью tlist.exe. Чтобы получить файл tlist.exe, скачайте и установите средства отладки для Windows, которые доступны на странице скачиваемых файлов WDK и WinDbg.
Подключение к процессу .NET Core, выполняемому в Службе приложений Azure (Windows)
Если публикация выполняется в Службу приложений Azure (Windows), инструкции см. в статье об удаленной отладке ASP.NET Core в Azure или отладке служб приложение Azure.
Подключение к процессу .NET Core, выполняемому в Службе приложений Azure (Windows)
Если вы выполняете публикацию в Службу приложений Azure (Windows), параметр Подключить отладчик можно найти в меню . в разделе Размещение в профиле публикации. Visual Studio пытается подключить удаленный отладчик к экземпляру Службы приложений Azure (Windows), в котором публикуется профиль.
Подключение к процессу .NET Core под управлением Linux с помощью SSH
Присоединение к процессу, выполняющемуся в контейнере Docker
Начиная с Visual Studio 2019 можно подключить отладчик Visual Studio к процессу, выполняющемуся в контейнере Docker. Для контейнеров Docker в .NET Core для Linux см. раздел Присоединение к процессу, выполняющемуся в контейнере Docker для Linux. Для контейнеров Docker в Windows см. раздел Присоединение к процессу, выполняющемуся в контейнере Docker для Windows.
Повторное присоединение к процессу
Чтобы быстро присоединиться к процессам, к которым вы ранее были присоединены, выберите Отладка>Повторно подключиться к процессу (SHIFT+ALT+P). При выборе этой команды отладчик сразу же попытается присоединиться к последним процессам, к которым вы подключались, сначала попытавшись выполнить сопоставление с ИД предыдущего процесса, а если это не удается, то путем сопоставления с именем предыдущего процесса. Если совпадений не найдено или несколько процессов имеют одно и то же имя, откроется диалоговое окно Подключение к процессу, в котором можно выбрать правильный процесс.
Команда Повторно подключиться к процессу доступна начиная с Visual Studio 2017.
Распространенные сценарии отладки
Чтобы определить, следует ли использовать команду Подключиться к процессу и к какому процессу подключиться, используйте таблицу ниже, в которой приведены несколько распространенных сценариев отладки со ссылками на дополнительные инструкции, где это возможно. (Этот список не является исчерпывающим.)
Для некоторых типов приложений, например универсальных приложений для Windows (UWP), не следует напрямую подключаться к имени процесса. Вместо этого необходимо использовать команду Отладка установленного пакета приложения в Visual Studio (см. таблицу).
Чтобы отладчик мог присоединиться к коду на языке C++, код должен предоставлять DebuggableAttribute . Это можно добавить в код автоматически, путем связывания с параметром /ASSEMBLYDEBUG компоновщика.
Для отладки скриптов на стороне клиента в браузере должна быть включена отладка скриптов. Для отладки клиентского скрипта в Chrome выберите JavaScript или TypeScript в качестве типа кода и в зависимости от типа приложения может потребоваться закрыть все экземпляры Chrome и запустить браузер в режиме отладки (введите chrome.exe —remote-debugging-port=9222 из командной строки).
Для отладки скриптов на стороне клиента в браузере должна быть включена отладка скриптов. Для отладки клиентского скрипта в Chrome выберите JavaScript (Chrome) или JavaScript (Microsoft Edge — Chromium) в качестве типа кода, и, в зависимости от типа приложения, может потребоваться закрыть все экземпляры Chrome и запустить браузер в режиме отладки (введите chrome.exe —remote-debugging-port=9222 в командной строке). В более ранних версиях Visual Studio в качестве отладчика скриптов для Chrome использовался Веб-пакет.
Чтобы быстро выбрать выполняющийся процесс для подключения, в Visual Studio нажмите клавиши CTRL+ALT+P, а затем введите первую букву имени процесса.
| Сценарий | Метод отладки | Имя процесса | Примечания и ссылки |
|---|---|---|---|
| ASP.NET Core — удаленная отладка на сервере IIS | Используйте инструменты удаленной отладки и функцию Подключиться к процессу | w3wp.exe или dotnet.exe | Начиная с .NET Core 3 процесс w3wp.exe используется для модели размещения в приложении по умолчанию. Сведения о развертывании приложений см. в разделе Публикация в службах IIS. Дополнительные сведения см. в разделе Удаленная отладка ASP.NET Core на удаленном компьютере IIS |
| ASP.NET Core — отладка приложения на локальном компьютере после запуска приложения без отладчика | Используйте функцию Подключиться к процессу | msedge.exe | Это может быть полезно для ускорения загрузки приложения, например при профилировании. |
| ASP.NET 4 или 4.5 — удаленная отладка на сервере IIS | Используйте инструменты удаленной отладки и функцию Подключиться к процессу | w3wp.exe | См. раздел Удаленная отладка ASP.NET на удаленном компьютере IIS |
| Скрипт на стороне клиента — отладка на локальном сервере IIS для поддерживаемых типов приложений | Используйте функцию Подключиться к процессу | chrome.exe или msedge.exe | Необходимо включить отладку скриптов. Для Chrome необходимо также запустить Chrome в режиме отладки (введите chrome.exe —remote-debugging-port=9222 из командной строки) и выбрать JavaScript или TypeScript в поле «Подключение». |
| Приложение C#, Visual Basic или C++ — отладка на локальном компьютере | Используйте стандартную отладку (F5) или функцию Подключиться к процессу | .exe | В большинстве случаев используется стандартная отладка, а не функция Подключиться к процессу. |
| Классическое приложение Windows — удаленная отладка | Инструменты удаленной отладки | Н/П | См. раздел Удаленная отладка приложения C# или Visual Basic или Удаленная отладка приложения C++ |
| .NET Core в Linux — отладка | Используйте функцию Подключиться к процессу | dotnet.exe или уникальное имя процесса | Сведения об использовании см. в статье Удаленная отладка .NET Core в Linux с помощью SSH. Для контейнерных приложений см. раздел Присоединение к процессу, выполняющемуся в контейнере Docker. |
| Контейнерное приложение — отладка | Используйте функцию Подключиться к процессу | dotnet.exe или уникальное имя процесса | См. раздел Присоединение к процессу, выполняющемуся в контейнере Docker. |
| Python в Linux — удаленная отладка | Используйте функцию Подключиться к процессу | debugpy | См. раздел Удаленное подключение с помощью инструментов Python. |
| Другие поддерживаемые типы приложений — отладка в серверном процессе | Если сервер удаленный, используйте инструменты удаленной отладки и функцию Подключиться к процессу | chrome.exe, msedge.exe или другие процессы | При необходимости используйте монитор ресурсов, чтобы определить процесс. См. раздел Удаленная отладка. |
| Универсальное приложение для Windows (UWP), OneCore, HoloLens или Интернета вещей — удаленная отладка | Отладка установленного пакета приложения | Н/П | См. раздел Отладка установленного пакета приложения вместо использования функции Подключиться к процессу |
| Универсальное приложение для Windows (UWP), OneCore, HoloLens или Интернета вещей — отладка приложения, которое не было запущено из Visual Studio | Отладка установленного пакета приложения | Н/П | См. раздел Отладка установленного пакета приложения вместо использования функции Подключиться к процессу |
Использование функций отладчика
Чтобы использовать все функции отладчика Visual Studio (например, при обнаружении точек останова) при присоединении к процессу, приложение должно точно соответствовать локальным источнику и символам. То есть отладчик должен иметь возможность загрузки правильных файлов символов (PDB). По умолчанию для этого требуется отладочная сборка.
В сценариях удаленной отладки должен быть уже открыт исходный код (или копия исходного кода) в Visual Studio. Скомпилированные двоичные файлы приложения на удаленном компьютере должны поступать из той же сборки, что и на локальном компьютере.
В некоторых локальных сценариях отладки в Visual Studio можно выполнять отладку без доступа к источнику, если в приложении есть правильные файлы символов. По умолчанию для этого требуется отладочная сборка. Дополнительные сведения см. в разделе Указание файлов символов и исходных файлов.
Устранение ошибок присоединения
В некоторых сценариях отладчику может потребоваться помощь, чтобы правильно определить тип отлаживаемого кода. Если значения для подключения заданы правильно (проверить процесс можно в списке Доступные процессы), но отладчику не удается подключиться, попробуйте выбрать наиболее подходящий тип подключения в списке Тип подключения. Это может потребоваться, например, при отладке приложения Linux или Python. Если используется тип подключения «По умолчанию», можно также выбрать определенный тип кода для подключения, как описано далее в этом разделе.
При присоединении отладчика к выполняющемуся процессу этот процесс может содержать один или несколько типов кода. Типы кода, к которым может присоединиться отладчик, отображаются и выбираются в диалоговом окне Выбор типа кода .
Иногда отладчик может успешно присоединяться к одному типу кода, но не к другому. Это происходит в следующих случаях:
- При попытке присоединения к процессу, выполняющемуся на удаленном компьютере. На удаленном компьютере для одних типов кода могут иметься компоненты удаленной отладки, а для других — нет.
- При попытке присоединиться к двум или более процессам для прямой отладки базы данных. Отладка SQL поддерживает присоединение только к одному процессу.
Если отладчик может присоединиться не ко всем типам кода, отобразится сообщение со сведениями о типах, к которым присоединиться не удалось.
Если отладчик успешно подключается хотя бы к одному типу кода, то можно приступать к отладке процесса. Но отлаживать можно будет только те типы кода, к которым удалось подсоединиться. Неподключенный код в этом процессе будет по-прежнему выполняться, но задавать в этом коде точки останова, просматривать данные и выполнять другие операции отладки не удастся.
Если нужны более конкретные сведения о том, почему отладчику не удалось присоединиться к некоторому типу кода, попробуйте повторно присоединиться только к этому типу кода.
Чтобы получить подробные сведения о том, почему не удалось присоединиться к типу кода:
- Отключитесь от процесса. В меню Отладка выберите Отсоединить все.
- Вновь подключитесь к процессу, выбрав только тип кода.
- В диалоговом окне Присоединение к процессу выберите процесс в списке Доступные процессы.
- Выберите Выбрать.
- В диалоговом окне Выбор типа кода выберите Выполнять отладку кода следующих типов и выберите тип кода, к которому не удалось присоединиться. Отмените выбор других типов кода.
- Нажмите ОК.
- В диалоговом окне Подключение к процессу нажмите Подключиться.
На этот раз присоединение не пройдет полностью, и будет выдано сообщение о конкретной ошибке.
См. также
- Отладка нескольких процессов
- JIT-отладка
- Удаленная отладка
Присоединение к программе
Область применения:
Visual Studio Visual Studio для Mac Visual Studio Code После регистрации программ с соответствующим портом необходимо подключить отладчик к программе, которую вы хотите отладить.
Выбор способа присоединения
Существует три способа, с помощью которых диспетчер отладки сеансов пытается подключиться к отлаживаемой программе.
- Для программ, запускаемых подсистемой отладки с помощью метода LaunchSuspended (типичный для интерпретированных языков, например), SDM получает интерфейс IDebugProgramNodeAttach2 из объекта IDebugProgramNode2, связанного с присоединенной программой. Если SDM может получить IDebugProgramNodeAttach2 интерфейс, SDM вызывает метод OnAttach . Метод IDebugProgramNodeAttach2::OnAttach возвращается S_OK , чтобы указать, что он не был присоединен к программе и что другие попытки можно выполнить для присоединения к программе.
- Если SDM может получить интерфейс IDebugProgramEx2 из подключенной программы, SDM вызывает метод Attach . Этот подход является типичным для программ, которые были запущены удаленно поставщиком портов.
- Если программа не может быть подключена через IDebugProgramNodeAttach2::OnAttach метод или IDebugProgramEx2::Attach методы, SDM загружает подсистему отладки (если она еще не загружена), вызывая CoCreateInstance функцию, а затем вызывает метод Attach . Этот подход является типичным для программ, запускаемых локально поставщиком портов. Кроме того, поставщик пользовательского порта может вызвать IDebugEngine2::Attach метод в реализации поставщика пользовательского IDebugProgramEx2::Attach порта. Как правило, в этом случае поставщик пользовательского порта запускает подсистему отладки на удаленном компьютере. Вложение достигается, когда диспетчер отладки сеанса вызывает метод Attach . Если вы запускаете de de в том же процессе, что и приложение для отладки, необходимо реализовать следующие методы IDebugProgramNode2:
- GetHostName
- GetHostPid
- GetProgramName IDebugEngine2::Attach После вызова метода выполните следующие действия в реализации IDebugEngine2::Attach метода:
Примечание. При реализации IDebugProgramNodeAttach2 интерфейса программа GUID передается методу IDebugProgramNodeAttach2::OnAttach . Используется GUID для возвращаемых методом IDebugProgram2::GetProgramId программ GUID .
Примечание. Это не тот же IDebugProgram2 объект, который был передан в IDebugEngine2::Attach метод. Ранее переданный IDebugProgram2 объект распознается только портом и является отдельным объектом.
Связанный контент
- Вложение на основе запуска
- Отправка событий
- LaunchSuspended
- IDebugProgram2
- IDebugProgramCreateEvent2
- IDebugProgramNodeAttach2
- OnAttach
- IDebugProgramNode2
- GetProgramId
- IDebugProgramEx2
- Присоединить
- Присоединить
Не удается присоединиться к процессу
Область применения:
Visual Studio Visual Studio для Mac Visual Studio Code Не удается присоединиться к процессу. Компонент отладчика на сервере получил отказ в доступе при подключении к этому компьютеру.
Существуют два типичных скрипта, вызывающих эту ошибку:
Сценарий 1. Компьютер A работает под управлением Windows XP. Компьютер B работает под управлением Windows Server 2003. Реестр на компьютере B содержит следующее значение DWORD:
Пользователь 1 запускает сеанс службы терминалов (сеанс 1) на компьютере B и запускает управляемое приложение из этого сеанса.
Пользователь 2, являющийся администратором обоих компьютеров, вошел в систему компьютера A. С этого компьютера он пытается установить подключение к приложению, которое выполняется в сеансе 1 на компьютере B.
Сценарий 2. Один пользователь зашел в систему на двух компьютерах — A и B — в одной и той же рабочей группе, используя одинаковые пароли на обоих компьютерах. Отладчик выполняется на компьютере A и пытается подключиться к управляемому приложению, работающему на компьютере B. Компьютер A имеет сетевой доступ: модель общего доступа и безопасности для локальных учетных записей , для которых задано значение Guest.
Решение скрипта 1
- Запустите отладчик и управляемое приложение под одним и тем же именем учетной записи пользователя и паролем.
Решение скрипта 2
- В меню Пуск выберите Панель управления.
- На панели управления дважды щелкните Администрирование.
- В окне «Администрирование» дважды щелкните пункт Локальная политика безопасности.
- В окне «Локальная политика безопасности» выберите Локальные политики.
- В столбце Политики дважды щелкните Сетевой доступ: модель совместного доступа и безопасности для локальных учетных записей.
- В диалоговом окне Доступ к сети: модели безопасности и совместного использования локальных учетных записей измените локальный параметр безопасности на Классический и нажмите кнопку ОК.
Внимание Изменение модели безопасности на обычную может привести к непредвиденным возможностям доступа к общим файлам и DCOM-компонентам. Если сделать это, удаленный пользователь сможет проходить проверку подлинности под локальной учетной записью пользователя вместо записи «Гость». Если удаленный пользователь совпадает с именем пользователя и паролем, он сможет получить доступ к любой папке или объекту DCOM, которым вы предоставили общий доступ. Если вы используете эту модель безопасности, убедитесь, что все учетные записи пользователей на компьютере имеют надежные пароли или настройте изолированный сетевой остров для отладчика и отладки компьютеров, чтобы предотвратить несанкционированный доступ.
См. также
Присоединение и отключение программы
Область применения:
Visual Studio Visual Studio для Mac Visual Studio Code Присоединение отладчика требует отправки правильной последовательности методов и событий с соответствующими атрибутами.
Последовательность методов и событий
- Диспетчер отладки сеанса вызывает метод OnAttach . На основе модели IDebugProgramNodeAttach2::OnAttach процесса обработчика отладки (DE) метод возвращает один из следующих методов, который определяет, что происходит дальше. Если S_FALSE возвращается, подсистема отладки успешно подключена к программе. В противном случае метод Attach вызывается для завершения процесса присоединения. Если S_OK возвращается, de de должен быть загружен в том же процессе, что и SDM. SDM выполняет следующие задачи:
- Вызывает GetEngineInfo , чтобы получить сведения о подсистеме DE.
- Совместно создает DE.
- Подключение вызовов.
Связанный контент