遠端偵錯

你可以除錯已部署在不同電腦上的 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 2022 與 2026 的遠端工具可搭配任一版本的 Visual Studio 使用。 然而，早於 Visual Studio 2022 的遠端工具版本與較晚版本的 Visual Studio 不相容。 （例如，如果你使用 Visual Studio 2019，請下載 Visual Studio 2019 遠端工具的最新更新。在這種情況下，不要下載 Visual Studio 2022 的遠端工具。）

• 下載遠端工具，其架構與您安裝所在的計算機相同。 例如，如果您想要在執行 x64 作業系統的遠端電腦上偵錯 x86 應用程式，請安裝 x64 遠端工具。 若要在 ARM64 作業系統上偵錯 x86、ARM 或 x64 應用程式，請安裝 ARM64 遠端工具。

版本	連結	筆記
Visual Studio 2026	遠端工具	相容於 Visual Studio 2022 及更新版本。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在舊版 Windows Server 上，請參閱 解除封鎖檔案下載，以取得下載遠端工具的說明。
Visual Studio 2022	遠端工具	2022 Visual Studio 的遠端工具可於 My.VisualStudio.com 取得。 如被要求，加入免費的 Visual Studio Dev Essentials 計畫，或以Visual Studio訂閱 ID 登入。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在舊版 Windows Server 上，請參閱 解除封鎖檔案下載，以取得下載遠端工具的說明。
Visual Studio 2019	遠端工具	2019 Visual Studio 的遠端工具可於 My.VisualStudio.com 取得。 如被要求，加入免費的 Visual Studio Dev Essentials 計畫，或以Visual Studio訂閱 ID 登入。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在舊版 Windows Server 上，請參閱 解除封鎖檔案下載，以取得下載遠端工具的說明。
Visual Studio 2017	遠端工具	2017 Visual Studio 的遠端工具可於 My.VisualStudio.com 取得。 如被要求，加入免費的 Visual Studio Dev Essentials 計畫，或以Visual Studio訂閱 ID 登入。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在 Windows Server 上，請參閱 解除封鎖檔案下載，以取得下載遠端工具的協助。
Visual Studio 2015	遠端工具	2015 Visual Studio 的遠端工具可於 My.VisualStudio.com 取得。 如被要求，加入免費的 Visual Studio Dev Essentials 計畫，或以Visual Studio訂閱 ID 登入。 在 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 服務包 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

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

2. 在Visual Studio電腦上分享 Remote Debugger 資料夾。

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

提示

關於命令列安裝與命令列參考，請參考 msvsmon.exe 的說明頁面，在安裝了 Visual Studio 的電腦上於命令列輸入 msvsmon.exe /?（或者在遠端除錯器中進入 說明 > 用法）。

設定遠端調試程式

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

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

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

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

   在大多數情況下，請選擇 「配置遠端除錯」。

   遠端調試程式設定的螢幕快照。遠端調試程式組態

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++ 應用程式，你可以透過設定 project 屬性並啟動除錯器，從 Visual Studio 啟動遠端應用程式。 更多資訊請參見 遠端偵錯 C# 或 Visual Basic 專案或 遠端偵錯 C++ 專案。

你也可以遠端除錯非Visual Studio project的執行檔，雖然支援的除錯功能會依配置（例如符號的可用性）而有所不同。 更多資訊請參閱 非 Visual Studio 專案解決方案中的應用程式除錯。

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

在 ASP.NET 及其他伺服器環境中除錯時，你必須以管理員身份執行遠端除錯器，或者如果你希望它持續運行，則以服務形式執行遠端除錯器。

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

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

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

3. 請勾選 Run the Visual Studio Remote Debugger as a service 勾選框。

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

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

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

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

7. 點選 [完成]。

   此時，遠端調試程式會以服務的形式執行。 你可以到 Control Panel > Services 並搜尋 Visual Studio Remote Debugger 來驗證。

   你可以從 Control Panel > Services 停止並啟動遠端除錯服務。

使用遠端符號設定偵錯

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

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

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

相關內容

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