Résolution des problèmes d’installation et de mise à niveau de Visual Studio

S’applique à :Visual Studio Visual Studio pour Mac Visual Studio Code

Conseil

Vous rencontrez un problème d’installation ? Nous pouvons vous aider. Nous proposons une option d’assistance par conversation instantanée (en anglais uniquement) pour l’installation.

Ce guide de résolution des problèmes inclut des instructions détaillées qui doivent permettre de résoudre la plupart des problèmes d’installation.

Installations en ligne / mises à jour

Les résolutions possibles suivantes s’appliquent à une installation en ligne typique. Essayez-les dans l’ordre.

1. Vérifiez si le problème est un problème connu

La première chose à vérifier est de savoir si le problème que vous rencontrez est un problème connu de Visual Studio Installer que Microsoft s’efforce de résoudre.

Pour savoir s’il existe une solution de contournement à votre problème, consultez la section Problèmes connus des notes de publication.

Pour savoir s’il existe une solution de contournement à votre problème, consultez la section Problèmes connus des notes de publication.

2. Essayez de réparer Visual Studio

Ensuite, essayez de réparer votre installation. Cette solution résout de nombreux problèmes de mise à jour courants. Pour savoir comment réparer, consultez Réparer Visual Studio.

3. Découvrez ce que dit la communauté des développeurs à propos de l’erreur.

Si la réparation n’a pas résolu le problème, recherchez votre message d’erreur dans la Communauté des développeurs Visual Studio. D’autres membres de la communauté ont peut-être trouvé une solution ou une solution de contournement à votre problème.

4. Supprimez le dossier du programme d’installation (problèmes de mise à jour)

Si vous avez rencontré un problème lors de la mise à jour, essayez de supprimer le dossier de Visual Studio Installer, puis de réexécuter le programme d’amorçage de l’installation peut résoudre certains échecs de mise à jour. Cette opération réinstalle les fichiers de Visual Studio Installer et réinitialise les métadonnées d’installation.

1. Fermez le programme d’installation de Visual Studio.
2. Supprimez le répertoire d’installation de Visual Studio Installer. En règle générale, le répertoire est C:\Program Files (x86)\Microsoft Visual Studio\Installer.
3. Exécutez le programme d’amorçage de Visual Studio Le programme d’amorçage Visual Studio est un exécutable léger qui lance l’installation de Visual Studio Installer, puis le produit Visual Studio lui-même. Vous pouvez trouver le programme d’amorçage dans votre dossier Téléchargements sous un nom respectant le modèle vs_[Visual Studio edition]__*.exe. Si vous ne trouvez pas cette application, vous pouvez télécharger le programme d’amorçage en accédant à la page des téléchargements plus anciens de Visual Studio, puis en cliquant sur le bouton Téléchargement correspondant à votre édition de Visual Studio. Exécutez ensuite l’exécutable pour réinitialiser vos métadonnées d’installation.
4. Essayez à nouveau d’installer ou de mettre à jour Visual Studio. Si le programme d’installation continue d’échouer, passez à l’étape Signaler un problème.

1. Fermez le programme d’installation de Visual Studio.
2. Supprimez le dossier de Visual Studio Installer. En règle générale, le chemin d’accès au dossier est C:\Program Files (x86)\Microsoft Visual Studio\Installer.
3. Exécutez le programme d’amorçage du programme d’installation de Visual Studio. Vous pouvez trouver le programme d’amorçage dans votre dossier Téléchargements avec un nom de fichier qui correspond à un modèle vs_[Visual Studio edition]__*.exe. Vous pouvez également télécharger le programme d’amorçage de votre édition de Visual Studio à partir de la page téléchargements de Visual Studio. Exécutez ensuite l’exécutable pour réinitialiser vos métadonnées d’installation.
4. Essayez à nouveau d’installer ou de mettre à jour Visual Studio. Si Visual Studio Installer continue d’échouer, passez à l’étape Signaler un problème.

5. Signalez le problème à prendre en charge

Dans certaines situations, par exemple en cas de fichiers corrompus, les problèmes peuvent nécessiter un dépannage au cas par cas. Pour nous aider à vous aider, suivez les étapes suivantes :

1. Collecter vos journaux d’installation. Pour plus d’informations, consultez Guide pratique pour obtenir les journaux d’installation Visual Studio.
2. Ouvrez le programme d’installation de Visual Studio, puis cliquez sur Signaler un problème pour ouvrir l’outil Commentaires sur Visual Studio.
3. Indiquez le titre du problème signalé et les détails pertinents. Cliquez sur Suivant pour accéder à la section Pièces jointes, puis joignez le fichier journal généré (le fichier est généralement situé à l’emplacement %TEMP%\vslogs.zip).
4. Cliquez sur Suivant pour vérifier le problème signalé, puis sur Envoyer.

1. Collecter vos journaux d’installation. Pour plus d’informations, consultez Guide pratique pour obtenir les journaux d’installation Visual Studio.
2. Ouvrez Visual Studio Installer, puis choisissez Signaler un problème pour ouvrir l’outil Commentaires sur Visual Studio.
3. Attribuez un titre à votre rapport de problème, et fournissez les détails pertinents. Le journal d’installation le plus récent de Visual Studio Installer est automatiquement ajouté à la section Pièces jointes supplémentaires de votre rapport de problème.
4. Cliquez sur Envoyer.

6. Supprimez tous les fichiers d’installation de Visual Studio

En dernier recours, vous pouvez supprimer tous les fichiers d’installation de Visual Studio et les informations sur le produit :

1. Suivez les étapes décrites dans cet article : Supprimez la page Visual Studio.
2. Réexécutez le programme d’amorçage de Visual Studio Installer. Vous pouvez trouver le programme d’amorçage dans votre dossier Téléchargements avec un nom de fichier qui correspond à un modèle vs_[Visual Studio edition]__*.exe. Vous pouvez également télécharger le programme d’amorçage de votre édition de Visual Studio à partir de la page téléchargements de Visual Studio.
3. Essayez de réinstaller Visual Studio.

7. Restauration vers une installation précédente

Important

Avant d’essayer de restaurer, apprenez-en davantage sur la fonctionnalité de restauration dans Visual Studio.

La restauration peut être désactivée ou votre tentative de restauration peut être annulée si vous êtes dans une organisation qui a des exigences de conformité de sécurité ou de mise à jour logicielle. Pour plus d’informations, contactez votre administrateur informatique.

Si aucune des étapes précédentes n’a permis de mettre à niveau Visual Studio, vous pouvez essayer de restaurer vers votre version précédemment installée. Depuis Visual Studio 2022 version 17.4, vous pouvez effectuer une restauration vers votre version précédemment installée si :

• Vous n’avez pas installé à partir d’une disposition.
• Votre version d’origine était sur le canal actuel version 17.1.7 ou ultérieure, ou sur le canal 17.0 Automne 2021 LTSC 17.0.10 ou ultérieure.

Vous pouvez restaurer votre version précédemment installée à l’aide de Visual Studio Installer ou à l’aide de la ligne de commande.

Pour restaurer à l’aide de Visual Studio Installer :

1. Lancez Visual Studio Installer sur votre ordinateur.
2. Dans le programme d’installation, recherchez l’édition de Visual Studio que vous avez installée.
3. Choisissez Plus.
4. Choisissez Restaurer vers la version précédente.
5. Sélectionnez OK pour confirmer votre choix.

8. Contactez notre conversation instantanée

Si aucune des étapes précédentes ne vous permet d’installer ou de mettre à niveau Visual Studio correctement, contactez-nous via notre option de support Conversation en direct (en anglais uniquement) pour obtenir une assistance supplémentaire.

7. Contactez notre conversation instantanée

Si aucune des étapes précédentes ne vous permet d’installer ou de mettre à niveau Visual Studio correctement, contactez-nous via notre option de support Conversation en direct (en anglais uniquement) pour obtenir une assistance supplémentaire.

Disposition réseau ou installations hors connexion

Pour résoudre les problèmes liés à une installation réseau, consultez Codes d’erreur ou Résoudre les erreurs liées au réseau lorsque vous installez ou utilisez Visual Studio.

Mises à jour d’administrateur

Les mises à jour d’administrateur peuvent ne pas être appliquées correctement en raison de diverses situations. Pour plus d’informations, consultez les codes d’erreur de dépannage des mises à jour de l’administrateur.

Collectez les journaux d’installation pour le Support Microsoft

Si vous contactez le Support Microsoft, il vous sera peut-être demandé de collecter les journaux d’installation à l’aide de l’outil de collecte des journaux de Microsoft Visual Studio et .NET Framework. L’outil de collecte des journaux permet de collecter des journaux d’installation à partir de tous les composants installés par Visual Studio, y compris .NET Framework, SDK Windows et SQL Server. Il permet également de collecter des informations sur l’ordinateur, un inventaire de Windows Installer et des informations du journal des événements Windows pour Visual Studio Installer, Windows Installer et System Restore.

Pour collecter les journaux :

1. Télécharger l’outil.

2. Ouvrez une invite de commandes d’administration.

3. Exécutez Collect.exe dans le dossier dans lequel vous avez enregistré l’outil.

   L’outil doit être exécuté sous le même compte utilisateur que l’installation défaillante. Si vous exécutez l’outil à partir d’un autre compte utilisateur, définissez l’option –user:<name> permettant de spécifier le compte utilisateur sous lequel l’installation défaillante a été exécutée. Exécutez Collect.exe -? à partir d’une invite de commandes d’administration pour des options supplémentaires et des informations d’utilisation.

L’outil génère un fichier vslogs.zip dans votre dossier %TEMP%, généralement à C:\Users\YourName\AppData\Local\Temp\vslogs.zip.

Problèmes d’installation de WebView2

Si les stratégies de groupe de votre organisation bloquent l’installation du composant WebView2, vous ne pourrez pas installer Visual Studio, car le programme d’installation nécessite l’installation de WebView2. Si cela se produit, vérifiez ces stratégies :

• Si Microsoft Edge « Install (WebView) » est configuré, il détermine si WebView2 peut être installé.
• Si la stratégie Microsoft Edge « Install (WebView) » n’est pas configurée, la stratégie Microsoft Edge « InstallDefault » détermine si WebView2 peut être installé.

Avertissement

Si aucune stratégie n’est configurée, l’installation de WebView2 est autorisée par votre organisation.