共用方式為


遠端偵錯

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

如需遠端偵錯的深入指示,請參閱下列主題。

案例 連結
Azure App Service 在 Azure 上對 ASP.NET Core 進行遠端偵錯,或若為 Visual Studio Enterprise,則參閱快照偵錯工具
Azure VM 在 Azure VM 上對 ASP.NET 進行遠端偵錯
Azure Service Fabric 部署 Azure Service Fabric 應用程式
ASP.NET 對 ASP.NET Core 進行遠端偵錯對 ASP.NET 進行遠端偵錯
C# 或 Visual Basic 遠端偵錯 C# 或 Visual Basic 專案
C++ 對 C++ 專案進行遠端偵錯
Docker 附加至在 Docker 容器中執行的處理序
Linux 透過連結至流程來使用 SSH 在 Linux 上對 .NET Core 進行偵錯
通用 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 文件中的下載頁面
版本 連結 備註
Visual Studio 2019 遠端工具 與所有 Visual Studio 2019 版本相容。 下載符合您裝置作業系統的版本 (x86、x64 (AMD64) 或 ARM64)。 在 Windows Server 上,請參閱將下載的檔案解除封鎖 ,以取得下載遠端工具的說明。 如需最新版本的遠端工具,請開啟 Visual Studio 2022 文件
Visual Studio 2017 遠端工具 與所有 Visual Studio 2017 版本相容。 下載符合您裝置作業系統的版本 (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

注意

Windows Phone 需要 USB 連線才能進行偵錯 (其不需要遠端工具)。

支援的硬體組態

  • 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

    Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x64\msvsmon.exe

    Program Files (x86)\Microsoft Visual Studio\2019\Enterprise\Common7\IDE\Remote Debugger\x86\msvsmon.exe

  2. 共用 Visual Studio 電腦上的 Remote Debugger 資料夾。

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

提示

如需命令列安裝和命令列參考,請參閱 msvsmon.exe 的 [說明] 頁面,方法是在已安裝 Visual Studio 的電腦上的命令列中輸入msvsmon.exe /? (或移至遠端偵錯工具中的 [說明] > [使用方式])。

設定遠端偵錯工具

  1. 在遠端電腦上,從 [開始] 功能表尋找並啟動遠端偵錯工具。

    如果您沒有遠端電腦上的系統管理權限,請以滑鼠右鍵按一下 [遠端偵錯工具] 應用程式,然後選取 [以系統管理員身分執行]。 否則,只要正常啟動即可。

    如果您打算連結至以系統管理員身分執行的程序,或是在不同使用者帳戶下執行的程序,請以滑鼠右鍵按一下 [遠端偵錯工具] 應用程式,然後選取 [以系統管理員身分執行]。 如需詳細資訊,請參閱以系統管理員身分執行遠端偵錯工具

  2. 第一次啟動遠端偵錯工具時 (或設定遠端工具之前),遠端偵錯設定精靈會隨即出現。

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

    遠端偵錯工具設定的螢幕擷取畫面。

    遠端偵錯工具設定的螢幕擷取畫面。

    如果沒有安裝 Windows Web 服務 API (只有在 Windows Server 2008 R2 上才會發生這種情況),請選取 [安裝] 按鈕。

  3. 請選取至少一個您想要在其中使用遠端工具的網路類型。 如果此電腦經由網域連線,您就必須選擇第一個項目。 如果電腦經由工作群組或家用群組連線,請視情況選擇第二個或第三個項目。

    接下來,選取 [完成] 以啟動遠端偵錯工具。

    接下來,選取 [設定遠端偵錯] 以啟動遠端偵錯工具。

  4. 設定完成時,[遠端偵錯工具] 視窗會隨即出現。

    遠端偵錯工具視窗的螢幕擷取畫面

    遠端偵錯工具視窗的螢幕擷取畫面

    遠端偵錯工具現在會等候連線。 使用顯示的伺服器名稱和連接埠號碼,在 Visual Studio 中設定遠端連線設定。

若要停止遠端偵錯工具,請選取 [檔案]>[結束]。 您可以從 [開始] 功能表或從命令列將其重新啟動:

<Remote debugger installation directory>\msvsmon.exe

設定遠端偵錯工具

在您第一次啟動遠端偵錯工具後,可以變更其組態的某些部分。

  • 如果您需要新增其他使用者連線到遠端偵錯工具的權限,請選擇 [工具] > [權限]。 您必須具有系統管理員權限才能授與或拒絕使用權限。

    重要

    您在其下執行遠端偵錯工具的使用者帳戶可與您在 Visual Studio 電腦上使用的使用者帳戶不同,但您必須將不同的使用者帳戶新增至遠端偵錯工具的權限。

    或者,您可以從命令列使用 /allow <username> 參數啟動遠端偵錯工具:msvsmon /allow <username@computer>

  • 若您需要變更驗證模式或連接埠號碼,或指定遠端工具的逾時值:請選擇 [工具 > 選項]

    如需根據預設使用的連接埠號碼清單,請參閱遠端偵錯工具連接埠指派

    警告

    您可以選擇在 [非驗證] 模式下執行遠端工具,但非常不建議您使用這個模式。 在此模式中執行時不具有網路安全性。 只有在確定網路沒有面臨惡意或攻擊流量的風險時,才能選擇非驗證模式。

(選用) 將遠端偵錯工具設定為服務

如需在 ASP.NET 和其他伺服器環境中進行偵錯,您必須以系統管理員身分執行遠端偵錯工具,或者,如果您想要其始終執行,請以服務方式執行遠端偵錯工具。

如果您想要將遠端偵錯工具設定為服務,請遵循下列步驟。

  1. 尋找 [遠端偵錯工具組態精靈] (rdbgwiz.exe)。 (這是和「遠端偵錯工具」不同的應用程式)。僅當您安裝遠端工具時,才可使用。 它不會隨 Visual Studio 一同安裝。

  2. 開始執行 [組態精靈]。 當第一頁出現時,按一下 [下一步]

  3. 核取 [以服務方式執行 Visual Studio 遠端偵錯工具] 核取方塊。

  4. 加入使用者帳戶的名稱和密碼。

    您可能需要將 [以服務方式登入] 使用者權限新增至此帳戶 (在 [開始] 頁面或視窗中尋找 [本機安全性原則] (secpol.msc),或在命令提示字元中輸入 secpol)。 視窗出現時,請按兩下 [使用者權限指派] ,然後在右窗格中尋找 [以服務方式登入] 。 對它按兩下。 將使用者帳戶新增至 [屬性] 視窗,然後按一下 [確定]。 按一下 [下一步] 。

  5. 選取您要遠端工具與之通訊的網路類型。 必須至少選取一種網路類型。 如果此電腦經由網域連線,您就必須選擇第一個項目。 如果此電腦經由工作群組或家用群組連線,您就必須選擇第二個或第三個項目。 按一下 [下一步] 。

  6. 如果可以啟動服務,您就會看到 [您已順利完成 Visual Studio 遠端偵錯工具組態精靈] 。 如果無法啟動服務,您就會看到 [無法完成 Visual Studio 遠端偵錯工具組態精靈] 。 此頁面也會提供啟動服務所需遵循的一些祕訣。

  7. 按一下完成

    此時 [遠端偵錯工具] 會以服務方式執行。 您可以移至 [控制台] > [服務],然後尋找 [Visual Studio 遠端偵錯工具]

    您可以從 [控制台] > [服務] 停止和啟動遠端偵錯工具服務。

設定遠端符號偵錯

您應該能夠使用您在 Visual Studio 電腦產生的符號偵錯程式碼。 當您使用本機符號時,遠端偵錯工具的效能會更好。 如果您必須使用遠端符號,就必須告訴 [遠端偵錯監視] 在遠端電腦上尋找符號。

您可以使用下列 msvsmon 命令列參數以使用 Managed 程式碼的遠端符號:Msvsmon /FallbackLoadRemoteManagedPdbs

如需詳細資訊,請參閱遠端偵錯的說明 (在 [遠端偵錯工具] 視窗中按 F1,或按一下 [說明] > [使用量])。