C# 偵錯設定的專案設定 (.NET Core、.NET 5+ 和 ASP.NET Core)

發行項
10/05/2023

您可以在專案屬性頁的 [偵錯] 索引標籤和 [組建] 索引標籤中變更 C# 專案偵錯設定。

若要開啟屬性頁面，請選取 [方案總管] 中的專案，然後選取 [屬性] 圖示，或以滑鼠右鍵按一下專案並選取 [屬性]。

如需詳細資訊，請參閱偵錯和發行組態。

重要

這些設定不適用於 .NET Framework 或 UWP 應用程式。若要設定 .NET Framework 的偵錯設定，請參閱 C# 偵錯設定的專案設定。

偵錯索引標籤

從 Visual Studio 2022 開始，在 [偵錯] 索引標籤中選擇 [開啟偵錯啟動設定檔 UI]，以開啟啟動設定檔 UI 並變更偵錯設定。

啟動設定檔 (.NET Core、.NET 5+)

設定	描述
命令列引數	為要偵錯的應用程式指定命令列引數。命令名稱是在 [啟動外部程式] 指定的應用程式名稱。
工作目錄	指定為應用程式偵錯時的工作目錄。在 C# 中，工作目錄預設會 \bin\debug。
使用遠端電腦	針對遠端偵錯，選取此選項並輸入遠端偵錯目標的名稱，或 Msvsmon 伺服器名稱。遠端機器上的應用程式位置可在 [建置] 索引標籤的 [輸出路徑] 屬性中指定。其位置必須是遠端電腦上的可共用目錄。
環境變數	在執行應用程式處理序之前設定環境變數。針對 ASP.NET Core，請參閱環境。
啟用 Unmanaged 程式碼偵錯	對從託管應用程式對原生 (非託管) Win32 程式碼的呼叫進行偵錯。
啟用 SQL Server 偵錯	對 SQL Server Database 物件進行偵錯。
啟用 WebView2 偵錯	使用 Microsoft Edge (Chromium) 型偵錯工具對 JavaScript 進行偵錯。

啟動設定檔 (ASP.NET Core)

除了 .NET 5+ 的屬性之外，ASP.NET Core 啟動設定檔也包含不同 ASP.NET Core 設定檔的數個其他屬性。這些設定可為專案的 launchSettings.json 檔案提供簡單的 UI。如需此檔案的詳細資訊，請參閱在 ASP.NET Core 中使用多個環境中的「開發與 launchSettings.json」一節。

啟動設定檔 UI 中提供的設定包括下列各項。

設定	描述
啟動瀏覽器	選取是否要使用您在 [URL] 設定中設定的 URL，在開始偵錯時啟動預設瀏覽器。
Url	指定 .NET 或 .NET Core 的主機 URL 位置。對於以專案命名的設定檔 (也就是 launchSettings.json 中的 commandName 屬性是 Project)，Kestrel 伺服器會接聽指定的通訊埠。針對 IIS 設定檔，這通常與應用程式 URL 的值相同。如需詳細資訊，請參閱設定專案下的「IIS 啟動設定檔」一節。
應用程式 URL	指定應用程式 URL。針對以專案命名的設定檔，此屬性會指定 Kestrel 伺服器 URL，通常是 https://localhost:5001 和 http://localhost:5000

Visual Studio 預設會提供 IIS Express 設定檔，但是您可以建立其他設定檔，例如 IIS 設定檔。這些設定也會對應至 launchSettings.json 中的設定。這兩種設定檔類型提供數個設定，例如裝載模型。

設定	描述
裝載模型	指定 [同處理序] (預設值) 或 [跨處理序]。如需詳細資訊，請參閱 ASP.NET Core 文件中的裝載模型。
應用程式 SSL URL	針對 IIS Express，應用程式 SSL URL 通常是 http://localhost:44334.

建置索引標籤

下表顯示適用於偵錯的建置設定。如需建置設定的完整說明，請參閱建置頁面、專案設計工具。

設定	描述
一般>條件式編譯符號	若選取，會定義 DEBUG 和 TRACE 常數。這些常數可啟用 Debug 類別和 Trace 類別的條件式編譯。完成這些常數定義之後，Debug 和 Trace 類別方法即會於輸出視窗產生輸出。如果沒有這些常數，Debug 和 Trace 類別方法便不會編譯，且不會產生輸出。通常，DEBUG 會在組建的偵錯版本中定義，在發行版本中則不會定義。 TRACE 會在偵錯版本和發行版本中定義。
一般>最佳化程式碼	除非錯誤只出現在最佳化程式碼中，否則請在偵錯組建中取消選取此設定。因為指令無法直接對應到原始程式碼的陳述式，所以較難對最佳化程式碼進行偵錯。
偵錯符號	指定編譯器所產生的偵錯資訊類型。請參閱偵錯符號。如需如何設定應用程式效能偵錯的資訊，請參閱使映像偵錯更容易。
輸出>基底輸出路徑	指定中繼輸出的基底資料夾。若為偵錯組建，輸出通常會在 bin\Debug。
輸出>基底中繼輸出路徑	指定中繼輸出的基底資料夾。若為偵錯組建，輸出通常會在 obj\Debug。

偵錯符號

您可以選擇下列偵錯符號選項。

未發出任何符號

指定不會產生任何偵錯資訊。
PDB 檔案，目前的平台

產生 .PDB 檔案，這是平台特定符號檔，可將主要可執行檔中項目的資訊和其產生方式提供給其他工具 (特別是偵錯工具)。
PDB 檔案，可攜式

產生 .PDB 檔案，這是非平台特定可攜式符號檔，可將主要可執行檔中項目的資訊和其產生方式提供給其他工具 (特別是偵錯工具)。如需詳細資訊，請參閱 Portable PDB (可攜式 PDB)。
內嵌在 DLL/EXE 中，可跨平台攜帶

在組件中內嵌可攜式符號資訊。不會產生任何外部 .PDB 檔案。

如需詳細資訊，請參閱 /debug (C# 編譯器選項)。

另請參閱

偵錯設定和準備

共用方式為