通过

Visual Studio 安装和升级问题疑难解答

  • 项目

适用于： Visual Studio

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

提示

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

联机安装或更新

请按顺序尝试以下适用于典型在线安装问题的可能解决方案。

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

首先检查你遇到的问题是否是 Visual Studio 安装程序的已知问题（Microsoft 正在修复）。

若要查看问题是否有解决方法，请检查 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 安装程序引导程序。 你可能会在 Downloads 文件夹中找到引导程序，其文件名为 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. 选择“提交”。

  • 对于 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 安装程序引导程序。 可以在 Downloads 文件夹中找到引导程序，其文件名为 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 Fall 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）收集安装日志。 它还会收集计算机信息、Windows Installer 清单，以及 Visual Studio 安装程序、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。