Définir des configurations Debug et Release dans Visual Studio

Les projets Visual Studio ont des configurations Release et Debug distinctes pour votre programme. Vous générez la version Debug pour le débogage et la version Release pour la distribution de la version finale.

Dans la configuration Debug, votre programme est compilé avec des informations de débogage relatives aux symboles et aucune optimisation. L'optimisation complique le débogage, étant donné que la relation entre le code source et les instructions générées est plus complexe.

La configuration Release de votre programme ne contient pas d’informations de débogage relatives aux symboles et est entièrement optimisée. Pour le code managé et le code C++, les informations de débogage peuvent être générées dans des fichiers .pdb, selon les options de compilateur utilisées. La création de fichiers .pdb peut être utile si vous devez ultérieurement déboguer votre version Release.

Pour plus d’informations sur les configurations de build, consultez Présentation des configurations de build.

Vous pouvez modifier la configuration de build à partir du menu Générer, à partir de la barre d’outils ou dans les pages de propriétés du projet. Les pages de propriétés du projet sont spécifiques au langage. La procédure suivante montre comment changer la configuration de build à partir du menu et de la barre d'outils. Pour plus d'informations sur la modification de la configuration de build dans des projets dans différents langages, consultez la section Contenus connexes ci-dessous.

Changer la configuration de build

Pour changer la configuration de build :

• Dans la barre d’outils, choisissez Debug ou Release dans la liste Configurations de solutions.

  

  ou

• À partir du menu Générer, sélectionnez Gestionnaire de configurations, puis sélectionnez Debug ou Release.

Générer des fichiers de symbole (.pdb) pour une build (C#, C++, Visual Basic, F#)

Vous pouvez choisir de générer des fichiers de symbole (.pdb) et les informations de débogage à inclure. Pour la plupart des types de projets, le compilateur génère des fichiers de symboles par défaut pour les builds debug et release, tandis que d’autres paramètres par défaut diffèrent selon le type de projet et la version de Visual Studio.

Important

Le débogueur chargera uniquement un fichier .pdb pour un fichier exécutable qui correspond exactement au fichier .pdb créé lors de la génération du fichier exécutable (autrement dit, le fichier .pdb doit être le fichier d'origine ou une copie du fichier .pdb d'origine). Pour plus d’informations, consultez Pourquoi Visual Studio exige-t-il que les fichiers de symboles du débogueur correspondent exactement aux fichiers binaires avec lesquels ils ont été créés ?.

Chaque type de projet peut définir ces options de façon différente.

Générer des fichiers de symboles pour un projet C# ou ASP.NET Core (.NET Core, .NET 5+ uniquement)

Pour plus d’informations sur les paramètres de projet pour les configurations debug en C#, consultez Paramètres de projet pour une configuration de débogage C#. (Pour les projets .NET en Visual Basic, les fichiers de symboles sont configurés comme dans .NET Framework.)

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet et choisissez Propriétés.

2. Dans le volet latéral, choisissez Générer>Général.

3. Dans la section Optimiser le code, choisissez Debug ou Release.

4. Dans la liste Symboles de débogage, choisissez Fichier PDB, plateforme actuelle, Fichier PBD, portable ou Incorporé.

   Le format portable est le format multiplateforme le plus récent pour .NET Core. Pour plus d’informations sur les options, consultez la boîte de dialogue Paramètres de build avancés (C#).

   

5. Générez votre projet.

   Le compilateur crée le ou les fichiers de symboles dans le même dossier que l’exécutable ou le fichier de sortie principal.

Générer des fichiers de symboles pour un projet C#, ASP.NET ou Visual Basic (.NET Framework)

Pour plus d’informations sur les paramètres de projet pour les configurations debug en C# ou Visual Basic, consultez Paramètres de projet pour une configuration debug C# ou Paramètres de projet pour une configuration debug Visual Basic.

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet et choisissez Propriétés.

2. Dans le volet latéral, choisissez Générer (ou Compiler en Visual Basic).

3. Dans la liste Configuration en haut, choisissez Debug ou Release.

4. Sélectionnez le bouton Avancé (ou le bouton Options de compilation avancées en Visual Basic).

5. Dans la liste Informations de débogage (ou Générer des informations de débogage en Visual Basic), choisissez Complet, Pdb uniquement ou Portable.

   Le format portable est le format multiplateforme le plus récent pour .NET Core. Pour plus d’informations sur les options, consultez la boîte de dialogue Paramètres de build avancés (C#).

   

6. Générez votre projet.

   Le compilateur crée le ou les fichiers de symboles dans le même dossier que l’exécutable ou le fichier de sortie principal.

Générer des fichiers de symboles pour un projet C++

1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet et choisissez Propriétés.

2. Dans la liste Configuration, choisissez Debug ou Release.

3. Dans le volet latéral, choisissez Éditeur de liens > Débogage, puis sélectionnez options pour Générer des infos de débogage.

   Dans la plupart des projets C++, la valeur par défaut est Générer des informations de débogage (/DEBUG).

   Pour plus d’informations sur les paramètres de projet pour les configurations debug en C#, consultez Paramètres de projet pour une configuration debug C#.

4. Configurez les options pour Générer des fichiers de base de données de programme.

   Dans la plupart des projets C++, la valeur par défaut est $(OutDir)$(TargetName).pdb, qui génère des fichiers .pdb dans le dossier de sortie.

   

5. Générez votre projet.

   Le compilateur crée le ou les fichiers de symboles dans le même dossier que l’exécutable ou le fichier de sortie principal.

Contenu connexe

• Spécifier les fichiers de symboles (.pdb) et les fichiers source dans le débogueur Visual Studio
  
• Paramètres et préparation du débogueur
  
• Paramètres de projet pour une configuration Debug C++
  
• Paramètres de projet pour une configuration Debug C#
  
• Paramètres de projet pour une configuration Debug Visual Basic
  
• Guide pratique pour créer et modifier des configurations