Festlegen von Debug- und Releasekonfigurationen in Visual StudioSet debug and release configurations in Visual Studio

Visual Studio-Projekte verfügen über separate Release- und Debugkonfigurationen für Ihr Programm.Visual Studio projects have separate release and debug configurations for your program. Die Debugversion wird zum Debuggen und die Releaseversion für das endgültige Release verwendet.You build the debug version for debugging and the release version for the final release distribution.

In der Debugkonfiguration wird Ihr Programm mit vollständigen symbolischen Debuginformationen und ohne Optimierung kompiliert.In debug configuration, your program compiles with full symbolic debug information and no optimization. Die Optimierung gestaltet das Debuggen etwas schwieriger, da die Beziehung zwischen Quellcode und generierten Anweisungen komplexer ist.Optimization complicates debugging, because the relationship between source code and generated instructions is more complex.

Die Releasekonfiguration Ihres Programms verfügt über keine symbolischen Debuginformationen und wird vollständig optimiert.The release configuration of your program has no symbolic debug information and is fully optimized. Für verwalteten Code und C++-Code können Debuginformationen abhängig von den verwendeten Compileroptionen in PDB-Dateien generiert werden.For managed code and C++ code, debug information can be generated in .pdb files, depending on the compiler options that are used. Die Erstellung von PDB-Dateien kann hilfreich sein, wenn Sie später Ihre Releaseversion debuggen müssen.Creating .pdb files can be useful if you later have to debug your release version.

Weitere Informationen zu Buildkonfigurationen finden Sie unter Grundlagen der Buildkonfigurationen.For more information about build configurations, see Understand build configurations.

Sie können die Buildkonfiguration über die Symbolleiste im Menü Build oder über die Eigenschaftenseiten des Projekts ändern.You can change the build configuration from the Build menu, from the toolbar, or in the project's property pages. Die Eigenschaftenseiten des Projekts sind sprachspezifisch.Project property pages are language-specific. Das folgende Verfahren zeigt, wie die Buildkonfiguration über die Symbolleiste und das Menü geändert wird.The procedure below shows how to change the build configuration from the menu and the toolbar. Weitere Informationen zum Ändern der Buildkonfiguration in Projekten mit verschiedenen Sprachen finden Sie weiter unten im Abschnitt Siehe auch.For more information about how to change the build configuration in projects in different languages, see the See also section below.

Ändern der BuildkonfigurationChange the build configuration

Führen Sie zum Ändern der Buildkonfiguration eine der folgenden Aktionen aus:To change the build configuration, either:

  • Wählen Sie im Menü Build die Option Konfigurations-Manager und anschließend Debuggen oder Release aus.From the Build menu, select Configuration Manager, then select Debug or Release.

oderor

  • Wählen Sie auf der Symbolleiste im Listenfeld Projektmappenkonfigurationen die Option Debuggen oder Release aus.On the toolbar, choose either Debug or Release from the Solution Configurations list.

    Symbolleiste für die Buildkonfigurationtoolbars build configuration

Generieren von Symboldateien (PDB-Dateien) für einen Build (C#, C++, Visual Basic, F#)Generate symbol (.pdb) files for a build (C#, C++, Visual Basic, F#)

Sie können Symboldateien (PDB-Dateien) generieren und auswählen, welche Debuginformationen eingeschlossen werden sollen.You can choose to generate symbol (.pdb) files and what debug information to include. Bei den meisten Projekttypen werden vom Compiler standardmäßig Symboldateien für Debug- und Releasebuilds generiert. Andere Standardeinstellungen variieren dagegen je nach Projekttyp und Visual Studio-Version.For most project types, the compiler generates symbol files by default for debug and release builds, while other default settings differ by project type and Visual Studio version.

Wichtig

Der Debugger lädt nur eine PDB-Datei für eine ausführbare Datei, die genau mit der PDB-Datei übereinstimmt, die zum Zeitpunkt der Erstellung der ausführbaren Datei ebenfalls erstellt wurde (das heißt, die PDB-Datei muss die originale PDB-Datei oder eine Kopie der originalen PDB-Datei sein).The debugger will load only a .pdb file for an executable file that exactly matches the .pdb file that was created when the executable was built (that is, the .pdb must be the original or a copy of the original .pdb file). Weitere Informationen finden Sie unter Warum müssen Debuggersymboldateien exakt den Binärdateien entsprechen, mit denen sie erstellt wurden?.For more information, see Why does Visual Studio require debugger symbol files to exactly match the binary files that they were built with?.

Diese Optionen werden unter Umständen bei jedem Projekttyp anders festgelegt.Each project type may have a different way of setting these options.

Generieren von Symboldateien für ein C#-, ASP.NET- oder Visual Basic-ProjektGenerate symbol files for a C#, ASP.NET, or Visual Basic project

Ausführliche Informationen zu Projekteinstellungen für Debugkonfigurationen in C# oder Visual Basic finden Sie unter Projekteinstellungen für C#-Debugkonfigurationen bzw. unter Projekteinstellungen für eine Visual Basic-Debugkonfiguration.For detailed information on project settings for debug configurations in C# or Visual Basic, see Project settings for a C# debug configuration or Project settings for a Visual Basic debug configuration.

  1. Wählen Sie im Projektmappen-Explorer das Projekt aus.In Solution Explorer, select the project.

  2. Wählen Sie das Symbol Eigenschaften aus (oder drücken Sie ALT+EINGABE).Select the Properties icon (or press Alt+Enter).

  3. Wählen Sie im Seitenbereich die Option Erstellen aus (bzw. Kompilieren in Visual Basic).In the side pane, choose Build (or Compile in Visual Basic).

  4. Wählen Sie in der Liste Konfiguration die Option Debuggen oder Release aus.In the Configuration list, choose Debug or Release.

  5. Wählen Sie die Schaltfläche Erweitert aus (bzw. die Schaltfläche Erweiterte Kompilierungsoptionen in Visual Basic).Select the Advanced button (or the Advanced Compile Options button in Visual Basic).

  6. Wählen Sie in der Liste Debuginformationen (bzw. in der Liste Debuginfo generieren in Visual Basic) die Option Vollständig, Nur PDB oder Portierbar aus.In the Debugging information list (or the Generate debug info list in Visual Basic), choose Full, Pdb-only, or Portable.

    Das portierbare Format ist das neueste plattformübergreifende Format für .NET Core.The portable format is the most recent cross-platform format for .NET Core. Weitere Informationen zu den Optionen finden Sie unter Dialogfeld „Erweiterte Buildeinstellungen“ (C#).For more information on options, see Advanced Build Settings dialog box (C#).

    Generieren von PDB-Dateien für Builds in C#Generate PDBs for builds in C#

  7. Erstellen Sie das Projekt.Build your project.

    Die Symboldateien werden vom Compiler im gleichen Ordner erstellt wie die ausführbare Datei oder die Hauptausgabedatei.The compiler creates the symbol file(s) in the same folder as the executable or the main output file.

Generieren von Symboldateien für ein C++-ProjektGenerate symbol files for a C++ project

  1. Wählen Sie im Projektmappen-Explorer das Projekt aus.In Solution Explorer, select the project.

  2. Wählen Sie das Symbol Eigenschaften aus (oder drücken Sie ALT+EINGABE).Select the Properties icon (or press Alt+Enter).

  3. Wählen Sie in der Liste Konfiguration die Option Debuggen oder Release aus.In the Configuration list, choose Debug or Release.

  4. Wählen Sie im Seitenbereich Linker > Debuggen und anschließend Optionen für Debuginfo generieren aus.In the side pane, choose Linker > Debugging, then select options for Generate Debug Info.

    Ausführliche Informationen zu Projekteinstellungen für Debugkonfigurationen in C++ finden Sie unter Projekteinstellungen für eine C++-Debugkonfiguration.For detailed information on project settings for debug configurations in C++, see Project settings for a C++ debug configuration.

  5. Konfigurieren Sie Optionen für Programmdatenbankdatei erstellen.Configure options for Generate Program Database Files.

    In den meisten C++-Projekten wird der Standardwert $(OutDir)$(TargetName).pdb verwendet, wodurch PDB-Dateien im Ausgabeordner generiert werden.In most C++ projects, the default value is $(OutDir)$(TargetName).pdb, which generates .pdb files in the output folder.

    Generieren von PDB-Dateien für Builds in C++Generate PDBs for builds in C++

  6. Erstellen Sie das Projekt.Build your project.

    Die Symboldateien werden vom Compiler im gleichen Ordner erstellt wie die ausführbare Datei oder die Hauptausgabedatei.The compiler creates the symbol file(s) in the same folder as the executable or the main output file.

Siehe auchSee also