排查 Visual Studio 安装和升级问题

  • 项目

适用于： Visualstudio

此故障排除指南包括解决 Visual Studio 安装和升级常见问题的分步说明。

提示

安装时遇到问题？ 我们可以提供帮助。 我们提供 安装聊天 (仅英语) 支持选项。

联机安装或更新

按顺序尝试适用于典型联机安装问题的以下可能解决方法。

1.检查问题是否为已知问题

检查的第一件事是，你遇到的问题是否是 Microsoft 正在修复Visual Studio 安装程序的已知问题。

若要查看问题是否有解决方法，检查 Visual Studio 2019 的已知问题和Visual Studio 2022 的已知问题。

2.尝试修复 Visual Studio

尝试 修复安装。 它可以修复许多常见的更新问题。

3.查看开发人员社区对错误的看法

如果修复未解决问题，请在 Visual Studio 开发者社区中搜索错误消息。 社区的其他成员可能已找到你的问题的解决方案或解决方法。

4. 删除安装程序文件夹 (更新问题)

如果在更新时遇到问题，请尝试删除 Visual Studio 安装程序 文件夹，然后重新运行安装引导程序可以解决某些更新失败问题。 这样做会重新安装Visual Studio 安装程序文件并重置安装元数据。

  1. 关闭Visual Studio 安装程序。
  2. 删除Visual Studio 安装程序文件夹。 通常，文件夹路径为 C：\Program Files (x86) \Microsoft Visual Studio\Installer。
  3. 运行Visual Studio 安装程序引导程序。 你可能会在 “下载” 文件夹中找到名为 VisualStudioSetup.exe( Visual Studio 2022) 或 vs_<edition>*.exe (Visual Studio 2019 及以前版本) 的引导程序。 或者，可以从 Visual Studio 2022 或 Visual Studio 2019及早期版本的下载页下载引导程序。 然后，运行可执行文件以重置安装元数据。
  4. 再次尝试安装或更新 Visual Studio。 如果Visual Studio 安装程序继续失败，请向支持人员报告问题。

5. 向支持人员报告问题

在某些情况下，当存在损坏的文件时，问题可能需要逐个进行故障排除。

按照以下步骤将问题提交到Microsoft 支持部门：

  • 对于 Visual Studio 2022：

    1. 收集设置日志。 有关详细信息 ，请参阅如何获取 Visual Studio 安装日志 。

    2. 打开Visual Studio 安装程序，然后选择“报告问题”以打开 Visual Studio 反馈工具。

      显示Visual Studio 安装程序中的“提供反馈”按钮的屏幕截图。

    3. 为问题报告提供标题，并提供相关详细信息。 Visual Studio 安装程序的最新安装日志会自动添加到问题报告的“其他附件”部分。

    4. Choose Submit.

  • 对于 Visual Studio 2019 和早期版本：

    1. 收集设置日志。 有关详细信息 ，请参阅如何获取 Visual Studio 安装日志 。
    2. 打开Visual Studio 安装程序，然后选择“报告问题”以打开 Visual Studio 反馈工具。
    3. 为问题报告提供标题，并提供相关详细信息。 选择“ 下一步 ”转到“ 附件 ”部分，然后附加生成的日志文件 (通常 %TEMP%\vslogs.zip 位于) 。
    4. 选择“ 下一步 ”查看问题报告，然后选择“ 提交”。

6.删除所有 Visual Studio 安装文件

最后，可以删除所有 Visual Studio 安装文件和产品信息：

  1. 使用 InstallCleanup.exe删除所有 。
  2. 重新运行Visual Studio 安装程序引导程序。 可以在 “下载” 文件夹中找到名为 VisualStudioSetup.exe( Visual Studio 2022) 或 vs<edition>*.exe_ (Visual Studio 2019 及早期版本的引导程序) 。 或者，可以从 Visual Studio 2022 或 Visual Studio 2019及早期版本的下载页下载引导程序。
  3. 尝试重新安装 Visual Studio。

7. 仅) 回滚到 Visual Studio 2022 以前的安装 (

在尝试回滚之前，请详细了解 Visual Studio 中的回滚功能。

如果前面的步骤均未帮助你成功升级 Visual Studio，可以尝试回滚到以前安装的版本。 自 Visual Studio 2022 版本 17.4 起，如果原始版本位于当前通道版本 17.1.7 或更高版本上，或者位于 17.0 2021 年秋季 LTSC 通道 17.0.10 或更高版本上，则可以回滚到以前安装的版本。

可以使用 Visual Studio 安装程序或使用命令行回滚到以前安装的版本。

重要

如果你在组织中，并且正在使用布局来更新 Visual Studio，则如果客户端预期能够回滚，则 IT 管理员应维护布局中的先前包。 此外，如果你位于具有安全合规性或软件更新要求的组织中，可能会禁用回滚或撤消回滚尝试。 有关更多详细信息，请与 IT 管理员联系。

若要使用Visual Studio 安装程序回滚，请执行以下步骤：

  1. 在计算机上启动Visual Studio 安装程序。

  2. 在安装程序中，查找已安装的 Visual Studio 版本。

  3. 选择“ 更多”。

  4. 选择“ 回滚到以前的版本”。

    “回滚到以前的版本”选项的屏幕截图。

  5. 选择“确定”以确认。

8. 联系我们的实时聊天

如果前面的步骤都无法帮助你成功安装或升级 Visual Studio，请使用我们的 实时聊天 支持选项联系我们， (仅英语) 以获取进一步的帮助。

网络布局或脱机安装

若要解决 网络安装问题，请参阅 错误代码 或 排查安装或使用 Visual Studio 时与网络相关的错误。

管理员更新

由于各种情况，管理员更新可能无法正确应用。 有关详细信息，请参阅 管理员更新故障排除错误代码。

可以使用以下方法提供有关 Visual Studio 管理员更新或报告影响更新的问题的反馈：

收集Microsoft 支持部门的安装日志

如果你联系 Microsoft 支持部门，系统可能会要求你使用 Microsoft Visual Studio 收集安装日志，并.NET Framework日志收集工具。 日志收集工具从 Visual Studio 安装的所有组件（包括.NET Framework、Windows SDK和SQL Server）收集安装日志。 它还收集Visual Studio 安装程序、Windows Installer 和系统还原的计算机信息、Windows Installer 清单和 Windows 事件日志信息。

若要收集日志，请执行以下步骤：

  1. 下载该工具。

  2. 打开管理命令提示符。

  3. 在保存工具的文件夹中运行 Collect.exe 。

    必须在运行失败安装时所在的同一用户帐户下运行该工具。 如果从其他用户帐户运行该工具，请设置 -user:<name> 选项以指定运行失败安装的用户帐户。 从管理员命令提示符运行 Collect.exe -? 以获取更多选项和使用情况信息。

该工具在 %TEMP% 文件夹中生成 vslogs.zip 文件，通常在 C:\Users\YourName\AppData\Local\Temp\vslogs.zip。

使用“报告问题”工具向我们报告产品问题，该工具同时显示在 Visual Studio 安装程序 和 Visual Studio IDE 中。 如果你是 IT 管理员且未安装 Visual Studio，则可以在此处提交 IT 管理员反馈。

安装 WebView2 时出现问题

如果组织的组策略阻止安装 WebView2 组件，则无法安装 Visual Studio，因为安装程序需要安装 WebView2。 如果发生这种情况，检查以下策略：

警告

如果两个策略均未配置，则组织允许安装 WebView2。