请按顺序尝试以下适用于典型在线安装问题的可能解决方案。
1. 检查问题是否为已知问题
首先检查你遇到的问题是否是 Visual Studio 安装程序的已知问题(Microsoft 正在修复)。
若要查看问题是否有解决方法,请检查
Visual Studio 2019
的
已知问题和 Visual Studio 2022
的已知问题。
2. 尝试修复 Visual Studio
尝试
修复安装
。 它可能会修复许多常见的更新问题。
如果修复未解决问题,请在
Visual Studio 开发者社区
中搜索错误消息。 其他社区成员可能已经找到了你所遇到的问题的解决方法。
4. 删除安装程序文件夹(更新问题)
如果在更新时遇到问题,请尝试删除 Visual Studio 安装程序文件夹,然后重新运行安装引导程序,这样可以解决某些更新失败问题。 执行此操作将重新安装 Visual Studio 安装程序文件并重置安装元数据。
关闭 Visual Studio 安装程序。
删除 Visual Studio 安装程序文件夹。 通常,文件夹路径为
C:\Program Files (x86)\Microsoft Visual Studio\Installer
。
运行 Visual Studio 安装程序引导程序。 你可能会在
Downloads
文件夹中找到引导程序,其文件名
为 VisualStudioSetup.exe
(Visual Studio 2022) 或
vs_edition<*.exe>
(Visual Studio 2019 和以前的版本)。 或者,可以从 Visual Studio 2022
或
Visual Studio 2019 和早期版本的
下载页面下载引导程序。 然后,运行此可执行文件,重置安装元数据。
尝试重新安装或更新 Visual Studio。 如果Visual Studio 安装程序继续失败,
请报告问题以支持
。
5. 向支持人员报告问题
在某些情况下,如果存在损坏的文件,问题可能需要逐个排查。
按照以下步骤将问题提交到 Microsoft 支持:
对于 Visual Studio 2022:
收集安装日志。 有关详细信息,请参阅
如何获取 Visual Studio 安装日志
。
打开 Visual Studio 安装程序,然后选择“报告问题”打开 Visual Studio 反馈工具。
收集安装日志。 有关详细信息,请参阅
如何获取 Visual Studio 安装日志
。
打开Visual Studio 安装程序,然后选择“
报告问题
”以打开 Visual Studio 反馈工具。
为问题报告命名一个标题,然后输入相关详细信息。 选择“下一步”转到“附件
”部分,然后附加生成的日志文件(通常,该文件位于此位置
)。
%TEMP%\vslogs.zip
选择“下一步
”
以查看问题报告,然后选择“
提交
”。
6. 删除所有 Visual Studio 安装文件
作为最后一招,可以删除所有 Visual Studio 安装文件和产品信息:
使用 InstallCleanup.exe
删除所有内容。
重新运行 Visual Studio 安装程序引导程序。 可以在 Downloads
文件夹中找到引导程序
,其文件名
为 VisualStudioSetup.exe
(Visual Studio 2022) 或
vs
<edition>*.exe_ (Visual Studio 2019 和以前的版本)。 或者,可以从 Visual Studio 2022
或
Visual Studio 2019 和早期版本的
下载页面下载引导程序。
尝试重新安装 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 安装程序回滚,请执行以下步骤:
在计算机上启动 Visual Studio 安装程序。
在安装程序中,查找已安装的 Visual Studio 版本。
选择
更多
。
选择
回退到以前的版本
。
如果上述步骤均未帮助你成功安装或升级 Visual Studio,请使用我们的
实时聊天
支持选项(仅英语)与我们联系,以获取进一步的帮助。
网络布局或脱机安装
若要解决
网络安装
问题,请参阅
错误代码
或
排查在安装或使用 Visual Studio 时出现的网络相关错误
。
管理员更新
由于各种情况,管理员更新可能无法正确应用。 有关详细信息,请参阅
管理员更新故障排除错误代码
。
可使用以下方法,提供有关 Visual Studio 管理员更新的反馈或报告影响更新的问题:
在
Visual Studio 安装常见问题解答论坛
上向社区提问。
请转到
Visual Studio 支持页面
,检查你的问题是否在常见问题解答中列出。
就该体验向 Visual Studio 团队
提供功能反馈或报告问题
。
请联系您所在组织的 Microsoft 技术客户经理。
为 Microsoft 支持部门收集安装日志
如果你联系 Microsoft 支持部门,可能会被要求使用
Microsoft Visual Studio 和 .NET Framework 日志收集工具
收集安装日志。 日志收集工具从 Visual Studio 安装的所有组件(包括 .NET Framework、Windows SDK 和 SQL Server)收集安装日志。 它还会收集计算机信息、Windows Installer 清单,以及 Visual Studio 安装程序、Windows Installer 和系统还原的 Windows 事件日志信息。
若要收集日志,请执行以下步骤:
下载工具
。
打开管理命令提示符。
在保存工具的文件夹中运行
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。 如果发生这种情况,请检查以下策略:
如果配置了
Microsoft Edge“安装(WebView)”
,它会确定是否可以安装 WebView2。
如果未配置 Microsoft Edge“Install(WebView)”策略,
Microsoft Edge“InstallDefault”
策略将确定是否可以安装 WebView2。
如果两个策略均未配置,则组织允许安装 WebView2。