遠端偵錯

你可以除錯已部署在不同電腦上的 Visual Studio 應用程式。 要做到這點，你可以使用 Visual Studio 遠端除錯器。

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

場景	連結
C# 或 Visual Basic	遠端除錯 C# 或 Visual Basic 專案
C++	遠端除錯 C++ 專案
Azure App 服務	在 Azure 上遠端除錯 ASP.NET Core或對於 Visual Studio Enterprise，則使用快照除錯器
ASP.NET	遠端除錯 ASP.NET Core 或 遠端除錯 ASP.NET
Azure VM	在 Azure VM 上進行 ASP.NET 遠端調試
Linux	在 Linux 上使用 SSH 附加到程序來調試 .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，請參考 Unblock the file download 了解如何下載遠端工具。
Visual Studio 2022	遠端工具	2022 Visual Studio 的遠端工具可於 My.VisualStudio.com 取得。 如被要求，加入免費的 Visual Studio Dev Essentials 計畫，或以Visual Studio訂閱 ID 登入。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在較舊版本的 Windows Server，請參考 Unblock the file download 了解如何下載遠端工具。
Visual Studio 2019	遠端工具	2019 Visual Studio 的遠端工具可於 My.VisualStudio.com 取得。 如被要求，加入免費的 Visual Studio Dev Essentials 計畫，或以Visual Studio訂閱 ID 登入。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在較舊版本的 Windows Server，請參考 Unblock the file download 了解如何下載遠端工具。
Visual Studio 2017	遠端工具	2017 Visual Studio 的遠端工具可於 My.VisualStudio.com 取得。 如被要求，加入免費的 Visual Studio Dev Essentials 計畫，或以Visual Studio訂閱 ID 登入。 下載符合您裝置操作系統的版本（x86、x64（AMD64）或ARM64）。 在Windows Server上，請參考 Unblock the file download 了解如何下載遠端工具。
Visual Studio 2015	遠端工具	2015 Visual Studio 的遠端工具可於 My.VisualStudio.com 取得。 如被要求，加入免費的 Visual Studio Dev Essentials 計畫，或以Visual Studio訂閱 ID 登入。 在Windows Server上，請參考 Unblock the file download 了解如何下載遠端工具。
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。

要求

系統需求

遠端工具支援與 Visual Studio 相同的系統需求，但有些變動。 詳情請參閱您所在版本 Visual Studio 的系統需求：

• Visual Studio 2026 遠端工具的系統需求
• Visual Studio 2022 遠端工具系統需求
• 2019 Visual Studio 遠端工具系統需求

網路設定

遠端電腦與 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 /?（或在遠端除錯器中進入 Help > Usage）。

設定遠端調試程式

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

你也可以遠端除錯非 Visual Studio 專案中的執行檔，儘管支援的除錯功能會依設定而異，例如符號的可用性。 更多資訊請參閱 偵錯沒有包含在 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. 按一下完成。

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

   你可以從 控制台 > Services 停止並啟動遠端除錯服務。

使用遠端符號設定偵錯

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

您可以使用下列 msvsmon 命令列參數，將遠端符號用於受控程式碼： Msvsmon /FallbackLoadRemoteManagedPdbs

如需詳細資訊，請參閱遠端偵錯說明 （在遠端偵錯工具視窗中按 F1 ，或按一下 [說明 > 使用方式]）。

相關內容

• 初次使用偵錯器
• 設定Windows防火牆進行遠端除錯
• 遠端調試程式埠指派
• 在遠端 IIS 電腦上進行 ASP.NET Core 遠端除錯
• 遠端偵錯錯誤和故障排除