遠端偵錯

您可以偵錯已在不同電腦上部署的 Visual Studio 應用程式。 若要這樣做，您可以使用 Visual Studio 遠端調試程式。

如需遠端偵錯的深入指示，請參閱這些主題。

場景	連結
C# 或 Visual Basic	遠端偵錯 C# 或 Visual Basic 專案
C++	遠端偵錯C++專案
Azure App Service	Azure 上的遠端偵錯 ASP.NET Core，或 Visual Studio Enterprise 快照集調試程式
ASP.NET	遠端偵錯 ASP.NET Core 或 遠端偵錯 ASP.NET
Azure VM	遠端偵錯 Azure VM 上的 ASP.NET
Linux	使用 SSH 對 Linux 上的 .NET Core 進行偵錯，方法是附加至進程
Docker	附加至在 Docker 容器中運行的程序
通用 Windows 應用程式 （UWP）	在遠端電腦上執行 UWP 應用程式， 或 偵錯已安裝的應用程式套件

如果您只想下載並安裝遠端調試程式，而且不需要您案例的任何其他指示，請遵循本文中的步驟。

下載並安裝遠端工具

在您要偵錯的遠端裝置或伺服器上，而不是 Visual Studio 機器，從下表中的鏈接下載並安裝正確的遠端工具版本。

• 下載 Visual Studio 版本的最新遠端工具更新。 舊版遠端工具與較新的 Visual Studio 版本不相容。 （例如，如果您使用 Visual Studio 2019，請下載 Visual Studio 2019 遠端工具的最新更新。在此案例中，請勿下載 Visual Studio 2022 的遠端工具。
• 下載遠端工具，其架構與您安裝所在的計算機相同。 例如，如果您想要在執行 x64 作業系統的遠端電腦上偵錯 x86 應用程式，請安裝 x64 遠端工具。 若要在 ARM64 作業系統上偵錯 x86、ARM 或 x64 應用程式，請安裝 ARM64 遠端工具。

版本	連結	筆記
Visual Studio 2022	遠端工具	與所有 Visual Studio 2022 版本相容。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在舊版 Windows Server 上，請參閱 解除封鎖檔案下載，以取得下載遠端工具的說明。
Visual Studio 2019	遠端工具	Visual Studio 2019 的遠端工具可從 My.VisualStudio.com 取得。 如果出現提示，請加入免費的 Visual Studio Dev Essentials 方案，或使用您的 Visual Studio 訂用帳戶標識符登入。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在舊版 Windows Server 上，請參閱 解除封鎖檔案下載，以取得下載遠端工具的說明。
Visual Studio 2017	遠端工具	Visual Studio 2017 的遠端工具可從 My.VisualStudio.com 取得。 如果出現提示，請加入免費的 Visual Studio Dev Essentials 方案，或使用您的 Visual Studio 訂用帳戶標識符登入。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在 Windows Server 上，請參閱 解除封鎖檔案下載，以取得下載遠端工具的協助。
Visual Studio 2015	遠端工具	Visual Studio 2015 遠端工具可從 My.VisualStudio.com 取得。 如果出現提示，請加入免費的 Visual Studio Dev Essentials 方案，或使用您的 Visual Studio 訂用帳戶標識符登入。 在 Windows Server 上，請參閱 解除封鎖檔案下載，以取得下載遠端工具的協助。
Visual Studio 2013	遠端工具	Visual Studio 2013 檔中的下載頁面
Visual Studio 2012	遠端工具	Visual Studio 2012 檔中的下載頁面

您可以將 msvsmon.exe 複製到遠端電腦，而不是安裝遠端工具，以執行遠端調試程式。 不過，只有在安裝遠端工具時，才能使用遠端調試程式設定精靈（rdbgwiz.exe）。 如果您想要以服務的形式執行遠端調試程式，您可能需要使用精靈進行設定。 如需詳細資訊，請參閱 （選擇性） 將遠端除錯程式設定為服務。

注意

• 若要對 ARM 裝置上的 Windows 10 或更新版本應用程式進行偵錯，請使用 ARM64，其適用於最新版本的遠端工具。
• 若要對 Windows RT 裝置上的 Windows 10 應用程式進行偵錯，請使用 ARM，其僅適用於 Visual Studio 2015 遠端工具下載。
• 若要對 ARM64 操作系統上的 x64 應用程式進行偵錯，請執行隨 ARM64 遠端工具一起安裝的 x64 msvsmon.exe。

要求

支援的作業系統

遠端電腦必須執行下列其中一個作業系統：

• Windows 11

• Windows 10 （非手機）

• Windows 8 或 8.1 （非手機）

• Windows 7 Service Pack 1

• Windows Server 2016

• Windows Server 2012 或 Windows Server 2012 R2

• Windows Server 2008 Service Pack 2、Windows Server 2008 R2 Service Pack 1

支援的硬體組態

• 1.6 GHz 或更快的處理器

• 1 GB 的 RAM（如果在虛擬機上執行，則為 1.5 GB）

• 1 GB 的可用硬碟空間

• 5400-RPM 硬碟

• 支援 DirectX 9 的視訊卡，以 1024 x 768 或更高解析度顯示

網路設定

遠端電腦和 Visual Studio 電腦必須透過網路、工作組或家庭群組連線，或透過乙太網路纜線直接連線。 不支援透過 Proxy 連線的兩部電腦之間進行偵錯。 不建議在高延遲或低頻寬的連線環境下進行除錯，例如使用撥號上網，或透過因特網跨國家/地區進行，這樣可能會導致失敗或速度慢得無法接受。

（選擇性）從檔案共用執行遠程調試程式

您可以在已安裝 Visual Studio Community、Professional 或 Enterprise 的電腦上找到遠端調試程式 （msvsmon.exe）。 在某些情況下，設定遠端偵錯最簡單的方式是從檔案共用執行遠端調試程式（msvsmon.exe）。 如需使用限制，請參閱遠端調試程式的 [說明] 頁面 （[說明] > 遠端調試程式中的使用方式）。

1. 在符合 Visual Studio 版本的目錄中尋找 msvsmon.exe：

   Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe

   程式檔案\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x86\msvsmon.exe

2. 在 Visual Studio 電腦上共用 遠端調試程式 資料夾。

3. 在遠端電腦上，從共用資料夾執行 msvsmon.exe。 請遵循 設定指示。

提示

如需命令列安裝和命令列參考，請參閱 msvsmon.exe 的說明頁面，方法是在安裝有 Visual Studio 的電腦上，在命令列中輸入 msvsmon.exe /?（或移至遠端調試程式中的「說明」「使用方式」>）。

設定遠端調試程式

1. 在遠端電腦上，從 [開始] 功能表尋找並啟動 遠端調試程式。

   如果您沒有遠端電腦上的管理許可權，請以滑鼠右鍵點擊 遠端除錯程式 應用程式，然後選取[以系統管理員身分執行] 。 否則，只要正常啟動即可。

   如果您打算附加至以系統管理員身分執行的程序，或是在不同的使用者帳戶（例如 IIS）下執行，請右鍵點擊 遠端調試程式應用程式，然後選取 以系統管理員身分執行。 如需詳細資訊，請參閱 以系統管理員身分執行遠端調試程式。

2. 第一次啟動遠程調試程式（或設定之前），遠端偵錯組態 精靈隨即出現。

   在大部分情況下，請選擇 [下一步]，直到您進入精靈的 [設定 Windows 防火牆] 頁面 為止。

   

3. 選取至少一個您想要使用遠端工具的網路類型。 如果電腦是透過網域連線，您必須選擇第一個選項。 如果計算機是透過工作組或家庭群組連線，請視需要選擇第二或第三個專案。

   接下來，選取 完成 以啟動遠端調試程式。

4. 設定完成時，[遠端調試程式] 視窗隨即出現。

   

   遠端調試程式現在正在等候連線。 使用顯示的伺服器名稱和埠號碼，在 Visual Studio 中設定遠端聯機組態。

若要停止遠端除錯程式，請選擇 [[檔案]>[結束]。 您可以從 [開始] 選單，或從命令行將它重新啟動：

<Remote debugger installation directory>\msvsmon.exe

設定遠端調試程式

第一次啟動遠端調試程序之後，您可以變更遠端調試程式的設定的某些層面。

• 如果您需要為其他使用者新增連線至遠端調試程式的許可權，請選擇 [工具] > [許可權]。 您必須擁有系統管理員許可權，才能授與或拒絕許可權。

  重要

  您可以在與 Visual Studio 計算機上所使用的使用者帳戶不同的使用者帳戶下執行遠端調試程式，但您必須將不同的使用者帳戶新增至遠端調試程式的許可權。

  或者，您可以使用 /allow <username> 參數，從命令行啟動遠端調試程式：msvsmon /allow <username@computer>。

• 如果您需要變更驗證模式或連接埠號碼，或指定遠端工具的逾時值：選擇 [工具] > [選項]。

  如需預設使用的連接埠號碼清單，請參閱 遠端除錯程式埠指派。

  警告

  您可以選擇在 [無驗證] 模式中執行遠端工具，但強烈建議不要使用此模式。 當您在此模式中執行時，沒有網路安全性。 只有在您確定網路沒有惡意或惡意流量的風險時，才選擇 [無驗證] 模式。

設定 Visual Studio 以進行遠端偵錯

如需從 Visual Studio 連線到應用程式的詳細指示，請使用本文開頭與您特定案例相關的連結。

某些情境需要使用 [附加至程序] 來連線到已啟動的遠端應用程式。 不過，針對 .NET Core、.NET 5+、.NET Framework 和C++應用程式，您可以藉由設定專案屬性和啟動調試程式，從 Visual Studio 啟動遠端應用程式。 如需詳細資訊，請參閱 遠端偵錯 C# 或 Visual Basic 專案 或 遠端偵錯C++專案。

您也可以遠端偵錯不屬於 Visual Studio 專案的可執行檔，雖然支援的偵錯功能取決於組態，例如符號的可用性。 如需詳細資訊，請參閱 偵錯不屬於 Visual Studio 解決方案的應用程式。

（選擇性）將遠端調試程式設定為服務

若要在 ASP.NET 和其他伺服器環境中偵錯，您必須以系統管理員身分執行遠端調試程式，或者，如果您想要一律執行，請以服務的形式執行遠端調試程式。

如果您想要將遠端調試程式設定為服務，請遵循下列步驟。

1. 尋找 遠端調試程式組態精靈 （rdbgwiz.exe）。 （這是與遠端調試程式不同的應用程式。只有在您安裝遠端工具時，才能使用。 它未隨 Visual Studio 一起安裝。

2. 開始執行設定精靈。 當第一頁出現時，按兩下 [下一步]。

3. 核取 [執行 Visual Studio 遠端調試程式即服務 複選框。

4. 新增用戶帳戶和密碼的名稱。

   您可能需要將 作為服務登入的使用者權限 新增至此帳戶（在 開始 頁面或視窗中尋找 本機安全策略 (secpol.msc) 或在命令提示字元中輸入 secpol）。 當窗口出現時，按兩下 [用戶權力指派]，然後在右窗格中尋找 [以服務身分登入]。 按兩下它。 將用戶帳戶新增至 [屬性] 視窗，然後按兩下 [確定]]。 點選 [下一步]。

5. 選取您想要遠端工具與其通訊的網路類型。 至少必須選取一個網路類型。 如果電腦是透過網域連線，您應該選擇第一個選項。 如果計算機是透過工作組或家庭群組連線，您應該選擇第二或第三個項目。 點選 [下一步]。

6. 如果服務可以啟動，您會看到 您已成功完成 Visual Studio 遠端除錯程式設定精靈。 如果無法啟動服務，您會看到 無法完成 Visual Studio 遠端除錯程式設定精靈。 此頁面還提供一些可以遵循的提示，以協助啟用服務。

7. 點選 [完成]。

   此時，遠端調試程式會以服務的形式執行。 您可以移至 [控制面板] > Services，並尋找 Visual Studio 遠端調試程式來確認這一點。

   您可以從 [控制面板 ] > [服務]停止並啟動遠端調試程序服務。

使用遠端符號設定偵錯

您應該能夠使用您在 Visual Studio 電腦上產生的符號對程式代碼進行偵錯。 當您使用本機符號時，遠端調試程式的效能會更好。 如果您必須使用遠端符號，您必須告訴遠端偵錯監視器在遠端電腦上尋找符號。

您可以使用下列 msvsmon 命令列參數來使用管理程式碼的遠端符號：Msvsmon /FallbackLoadRemoteManagedPdbs

如需詳細資訊，請參閱遠端偵錯說明 （在遠端調試程序視窗中按 F1，或按兩下 [說明] > [使用量]]。

相關內容

• 初次檢視偵錯工具
• 設定 Windows 防火牆以進行遠端偵錯
• 遠端調試程式埠指派
• 在遠端 IIS 電腦上偵錯 ASP.NET Core
• 遠端偵錯錯誤和疑難解答