Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support. Show Troubleshoot Visual Studio installation and upgrade issues
In this articleApplies to: Visual Studio This troubleshooting guide includes step-by-step instructions to resolve common issues with Visual Studio installation and upgrade. Tip Having a problem installing? We can help. We offer an (English only) support option. Online installations or updatesTry the following possible resolutions that apply to a typical online installation issue in order. 1. Check whether the problem is a known issueThe first thing to check is whether or not the issue you're encountering is a known issue with the Visual Studio Installer that Microsoft is working on fixing. To see if there's a workaround for your problem, check and . 2. Try repairing Visual StudioTry to repair your installation. It may fix many common update issues. 3. See what the developer community says about the errorIf repairing didn't fix the issue, search for your error message in the Visual Studio Developer Community. Other members of the community might have found a solution or workaround to your problem. 4. Delete the installer folder (update issues)If you encountered an issue when updating, try deleting the Visual Studio Installer folder, and then rerunning the installation bootstrapper can solve certain update failures. Doing so reinstalls the Visual Studio Installer files and resets the installation metadata.
5. Report the problem to supportIn some situations, when there are corrupted files, issues might require case-by-case troubleshooting. Follow these steps to submit the problem to Microsoft Support:
6. Remove all Visual Studio installation filesAs a last resort, you can remove all Visual Studio installation files and product information:
7. Roll back to a previous install (for Visual Studio 2022 only)Before you try to roll back, learn more about the rollback feature in Visual Studio. If none of the previous steps helped you successfully upgrade Visual Studio, you can try to roll back to your previously installed version. Since Visual Studio 2022 version 17.4, you can roll back to your previously installed version if your original version was on the current channel version 17.1.7 or higher, or on the 17.0 Fall 2021 LTSC channel 17.0.10 or higher. You can roll back to your previously installed version by using the Visual Studio Installer or by using the command line. Important If you're in an organization and are using a layout to update Visual Studio, your IT Administrator is expected to maintain the previous packages in the layout if the client is expected to be able to roll back. Also, rollback may be disabled or your rollback attempt may be undone if you're in an organization that has security compliance or software updating requirements. Contact your IT Administrator for further details. To roll back with the Visual Studio Installer, follow these steps:
8. Contact our live chatIf none of the previous steps help you successfully install or upgrade Visual Studio, contact us by using our support option (English only) for further assistance. Network layout or offline installationsTo resolve issues with a network installation, see or Troubleshoot network-related errors when you install or use Visual Studio. Administrator updatesAdministrator updates may not be applied correctly due to various situations. For more information, see . You can use the following methods to provide feedback about Visual Studio administrator updates or report issues that affect the updates:
Collect installation logs for Microsoft SupportIf you contact Microsoft Support, you might be asked to collect setup logs by using the Microsoft Visual Studio and .NET Framework log collection tool. The log collection tool collects setup logs from all components installed by Visual Studio, including .NET Framework, Windows SDK, and SQL Server. It also collects computer information, a Windows Installer inventory, and Windows event log information for the Visual Studio Installer, Windows Installer, and System Restore. To collect the logs, follow these steps:
The tool generates a vslogs.zip file in your %TEMP% folder, typically at C:\Users\YourName\AppData\Local\Temp\vslogs.zip. Report product issues to us using the Report a Problem tool that appears both in the Visual Studio Installer and in the Visual Studio IDE. If you are an IT Administrator and don't have Visual Studio installed, you can submit IT Admin feedback here. Problems installing WebView2If your organization's Group policies block the installation of the WebView2 component, you won't be able to install Visual Studio because the installer requires WebView2 to be installed. If this happens, check these policies: |