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

适用于: Visual Studio

本文包含逐步说明,用于解决影响 Microsoft Visual Studio 安装和升级的常见问题。

提示

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

联机安装或更新

若要排查影响典型联机安装问题的问题,请尝试按给定顺序执行以下可能的解决方案。

检查问题是否为已知问题

若要检查 Visual Studio 安装程序中是否存在Microsoft正在积极修复的已知问题,请访问以下网站:

尝试修复 Visual Studio

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

了解开发人员社区对错误的看法

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

删除 Installer 文件夹(更新问题)

如果尝试更新程序时遇到问题,请尝试删除 Visual Studio Installer 文件夹,然后重新运行安装引导程序。 此操作能够解决某些更新失败。 它重新安装 Visual Studio 安装程序文件并重置安装元数据。 若要删除文件夹,请执行以下步骤:

  1. 关闭 Visual Studio 安装程序。

  2. 删除 Visual Studio 安装程序文件夹。 通常,文件夹路径为 C:\Program Files (x86)\Microsoft Visual Studio\Installer

  3. 运行 Visual Studio 安装程序引导程序。

    • 可以从 下载页获取最新版本 Visual Studio 的引导程序。 对于以前的 Visual Studio 版本,请参阅 旧版下载页

    • 还可以在 Downloads 文件夹中找到引导程序。 引导程序被命名为 VisualStudioSetup.exe(用于 Visual Studio 2022及更高版本),或 vs_<edition>.exe(用于 Visual Studio 2019及更早版本)。

  4. 请重试安装或更新 Visual Studio。 如果 Visual Studio 安装程序继续失败,请转到下一部分。

5.向Microsoft支持部门报告问题

在某些情况下,损坏的文件会导致需要逐个进行逐个故障排除的问题。 请执行适合您版本的 Visual Studio 的步骤。

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

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

    Visual Studio 安装程序中的“提供反馈”按钮。

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

  4. 选择提交

删除所有 Visual Studio 安装文件

作为最后一招,可以删除所有 Visual Studio 安装文件和产品信息:

  1. 使用 InstallCleanup.exe删除所有文件

  2. 重新运行 Visual Studio 安装程序引导程序。

    • 可以从 下载页获取最新版本 Visual Studio 的引导程序。 对于以前的 Visual Studio 版本,请参阅 旧版下载页

    • 还可以在 Downloads 文件夹中找到引导程序。 引导程序命名 VisualStudioSetup.exe 为 Visual Studio 2022 及更高版本,或 vs_<edition>.exe Visual Studio 2019 及更早版本。

  3. 请重试重新安装 Visual Studio。

7.回滚到以前的安装(Visual Studio 2022 及更高版本)

如果上述任何步骤都无法帮助你成功更新 Visual Studio,则可以使用 Visual Studio 安装程序或命令行将程序回滚到以前安装的版本。

重要

如果你在组织中使用布局来更新 Visual Studio,IT 管理员通常会维护布局中的以前的包。 这些包使客户端能够回滚安装。 此外,回滚过程可能会被禁用,或者您的回滚尝试可能会被撤销。 如果组织具有安全合规性或软件更新要求,则可能会出现这种情况。 有关更多详细信息,请联系 IT 管理员。

通过 Visual Studio 安装程序进行版本回滚
  1. 在计算机上启动 Visual Studio 安装程序

  2. 在安装程序中,查找 Visual Studio 的版本以匹配已安装的版本。

  3. 选择更多

  4. 选择 回退到以前的版本

    回退到以前的程序版本的选项。

  5. 若要确认作,请选择“ 确定”。

使用命令行回滚

你可以以编程方式回滚更新。 使用客户端计算机上的安装程序,并将回滚命令与安装路径实例一起传入。 例如:

VisualStudioSetup.exe rollback --installPath <VisualStudioInstallPath>

有关详细信息,请参阅 使用命令行参数安装 Visual Studio

联系我们的在线客服

如果上述任何解决方案都无帮助你成功安装或升级 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。