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

适用范围:yesVisual Studio noVisual Studio for Mac noVisual Studio Code

提示

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

本疑难解答指南包含可解决大多数安装问题的分步说明。

联机安装

以下步骤适用于典型的联机安装。 有关网络 (布局) 或脱机安装,请参阅 如何排查脱机安装问题

第 1 步 - 检查该问题是否为已知问题

Visual Studio 安装程序存在一些已知问题,Microsoft 正在努力修复中。 若要确定你遇到的问题是否有解决办法,请参阅发行说明的“已知问题”部分

Visual Studio 安装程序存在一些已知问题,Microsoft 正在努力修复中。 在发行说明的“已知问题”部分检查你遇到的问题是否已解决或查找解决方法。

第 2 步 - 尝试修复 Visual Studio

修复可解决许多常见的更新问题。 有关何时以及如何修复 Visual Studio 的详细信息,请参阅修复 Visual Studio

第 3 步 - 通过开发人员社区获取帮助

Visual Studio 开发者社区中搜索错误消息。 其他社区成员可能已经找到了你所遇到的问题的解决方法。

第 4 步 - 删除 Visual Studio 安装程序文件夹以修复升级问题

Visual Studio 引导程序是一个轻量级可执行文件,用于启动安装Visual Studio 安装程序然后启动 Visual Studio 产品的安装。 删除 Visual Studio 安装程序文件,然后重新运行引导程序即可解决一些更新失败问题。

注意

执行以下操作将重新安装 Visual Studio 安装程序文件并重置安装元数据。

  1. 关闭 Visual Studio 安装程序。
  2. 删除 Visual Studio 安装程序安装目录。 通常,该目录是 C:\Program Files (x86)\Microsoft Visual Studio\Installer
  3. 运行 Visual Studio 引导程序。 引导程序位于“下载”文件夹中,文件名格式为 vs_[Visual Studio edition]__*.exe。 如果找不到该应用程序,可以转到 Visual Studio 旧 版下载页并单击 Visual Studio 版本的 “下载 ”来下载引导程序。 然后,运行此可执行文件,重置安装元数据。
  4. 尝试重新安装或更新 Visual Studio。 如果安装程序继续失败,请继续执行 报告问题 步骤。
  1. 关闭 Visual Studio 安装程序。
  2. 删除 Visual Studio 安装程序文件夹。 文件夹路径通常为 C:\Program Files (x86)\Microsoft Visual Studio\Installer
  3. 运行 Visual Studio 安装程序引导程序。 引导程序可能位于“下载”文件夹中,其文件名与 vs_[Visual Studio edition]__*.exe 模式匹配。 或者,可以从 Visual Studio 下载页下载适用于你的 Visual Studio 版本的引导程序。 然后,运行此可执行文件,重置安装元数据。
  4. 尝试重新安装或更新 Visual Studio。 如果 Visual Studio 安装程序仍然失败,请继续执行报告问题步骤。

第 5 步 - 报告问题

在某些情况下(例如,有损坏的文件时),可能需要根据不同的案例排查问题。 为了帮助我们为你解决问题,请执行以下步骤:

  1. 收集安装日志。 有关详细信息,请参阅如何获取 Visual Studio 安装日志
  2. 打开 Visual Studio 安装程序,然后单击“报告问题”,打开 Visual Studio 反馈工具。 显示Visual Studio 安装程序中的“提供反馈”按钮的屏幕截图。
  3. 为问题报告命名一个标题,然后输入相关详细信息。 单击“下一步”,转到“附件”部分,然后附加生成的日志文件(此文件通常位于 %TEMP%\vslogs.zip)。
  4. 单击“下一步”,检查问题报告,然后单击“提交”。
  1. 收集安装日志。 有关详细信息,请参阅如何获取 Visual Studio 安装日志
  2. 打开 Visual Studio 安装程序,然后选择“报告问题”打开 Visual Studio 反馈工具。 显示Visual Studio 安装程序中的“提供反馈”按钮的屏幕截图。
  3. 为问题报告提供标题,并提供相关的详细信息。 Visual Studio 安装程序的最新安装日志将自动添加到问题报告的“其他附件”部分。
  4. 选择“提交”。

第 6 步 - 删除 Visual Studio 安装文件

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

  1. 按照以下文章中的步骤操作: 删除 Visual Studio 页。
  2. 重新运行 Visual Studio 安装程序引导程序。 引导程序可能位于“下载”文件夹中,其文件名与 vs_[Visual Studio edition]__*.exe 模式匹配。 或者,可以从 Visual Studio 下载页下载适用于你的 Visual Studio 版本的引导程序。
  3. 尝试重新安装 Visual Studio。

步骤 7 - 回滚

如果前面的步骤都无法帮助你成功升级 Visual Studio,可以尝试回滚到以前安装的版本。 在尝试回滚之前,请详细了解 Visual Studio 中的回滚功能

注意

使用 Visual Studio 2022 17.4,你将能够回滚到以前安装的版本。

  • 对于发布通道,如果版本为 17.0.10 或更高版本,或者 17.1.7 或更高版本,则可以回滚到以前安装的版本。
  • 对于预览频道,如果版本为 17.2 预览版 1 或更高版本,则可以回退到以前安装的版本。

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

使用Visual Studio 安装程序回滚

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

  2. 在安装程序中,查找已安装的 Visual Studio 版本。 接下来,选择“ 更多”,然后选择“ 回滚到以前的版本”。

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

  3. 选择“ 确定 ”以确认你的选择。

重要

如果你在具有安全合规性或软件更新要求的组织中,可能会禁用回滚或撤消回滚尝试。 有关更多详细信息,请与 IT 管理员联系。

步骤 8 - 联系我们 (可选)

如果上述步骤均未帮助你成功安装或升级 Visual Studio,请使用我们的实时聊天支持选项(仅英语)与我们联系,以获取进一步的帮助。

第 7 步 - 与我们联系(可选)

如果上述步骤均未帮助你成功安装或升级 Visual Studio,请使用我们的实时聊天支持选项(仅英语)与我们联系,以获取进一步的帮助。

网络布局或脱机安装

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

创建 脱机安装 并从网络或本地布局进行安装时,其他已知问题和解决方法可能会有所帮助。

问题 解决方案
用户无法访问文件 确保调整权限 (ACL),使其在你共享脱机安装之前先向其他用户授予读取访问权限。
无法安装新的工作负载、组件或语言包 如果从部分布局进行安装,并选择事先未为该部分布局下载的工作负载、组件或语言,请确保可以访问 Internet。

管理员汇报

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

安装日志

安装日志可帮助我们排查大部分安装问题。 使用 Visual Studio 安装程序中的报告问题提交问题时,Visual Studio 安装程序的最新安装日志将自动添加到报告中。

如果你联系 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
  4. 该工具会在 %TEMP% 文件夹中生成 vslogs.zip 文件,该文件的路径通常为 C:\Users\YourName\AppData\Local\Temp\vslogs.zip

注意

工具必须在安装失败时使用的同一用户帐户下运行。 若要从其他用户帐户运行工具,请设置 –user:<name> 选项,以指定安装失败时使用的用户帐户。 有关其他选项和使用情况信息,请通过管理员命令提示符运行 Collect.exe -?

安装 WebView2 时出现问题

WebView2 是 Visual Studio 所需的组件,但组织的组策略可能会阻止此组件的安装。 阻止安装 WebView2 将阻止安装 Visual Studio。

两个策略控制安装 WebView2 的能力:Microsoft Edge“安装 (WebView) ”Microsoft Edge“InstallDefault”。

• 如果配置了 Microsoft Edge“安装 (WebView) ”策略,它将确定是否可以安装 WebView2。 • 如果未配置 Microsoft Edge“安装 (WebView) ”策略,则 Microsoft Edge“InstallDefault”策略将确定是否可以安装 WebView2。

注意

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