通过

排查 Visual C++ 可再发行组件安装问题

本指南适用于使用 Visual Studio （VS） 安装程序或 Visual C++ 可再发行组件（VC Redist）安装程序安装 Visual C++ 运行时组件时遇到的问题。

如果遇到任何问题，请先确保安装 最新版本的 Visual C++ Redistributable。

收集失败日志

诊断 Visual C++ 可再发行组件安装程序问题的第一步是收集其故障日志。

  1. 下载 Microsoft Visual Studio 和 .NET 日志收集工具。
  2. 运行 Collect.exe。
  3. 提取%TEMP%/vscollect.zip的内容。

提取 vscollect.zip后，VC Redist 日志位于 Temp 该文件夹中。 相关日志文件以模式 dd_vcredist_<arch>_yyyyMMddHHmmss为前缀。

在 VC Redist 日志中搜索“错误”、“失败”或“系统错误”等术语，并查阅 常见错误 以识别问题。

其他日志位置

VC Redist 安装程序通常作为其他产品的先决条件执行。 在这种情况下，可以在其他路径中找到安装日志。

例如，Configuration Manager 在其自身的升级过程中，通过使用/l选项运行 vcredist_x64.exe 来升级 VC Redist，从而替代默认的日志位置。

在这种情况下，可以通过读取该产品自己的日志来找到日志的路径：

示例：Configuration Manager 日志

<ConfigMgr_Installation_Directory>\Logs\cmupdate.log

10-31-2025 17:40:06.421    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    [Visual C++ 2015-2022 Redistributable (x64)] with older version 14.28.29914 is installed. it needs to upgraded.
10-31-2025 17:40:06.421    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    INFO: Start install Visual C redistributable ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe"  /q /norestart /l "C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log").
10-31-2025 17:40:14.553    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    ERROR: Failed to install Visual C redistributable. Return code: 1603.
10-31-2025 17:40:14.553    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    ERROR: 64-bit VC Redist installation ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe") failed. Please check log file [C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log].
10-31-2025 17:40:14.554    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    Failed to install vc redist. Please manually install it from C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64

使用 Visual C++ 可再发行组件安装程序时的常规故障排除步骤

本部分介绍一般故障排除方法，可以尝试解决 VC Redist 安装程序的问题。

暂时禁用防病毒软件

防病毒软件通常阻止安装 VC Redist 组件。

  1. 关闭 Windows Defender 实时保护。
  2. 暂时禁用任何企业终结点保护（Symantec、McAfee 等）。
  3. 请重试安装。
  4. 重新启用任何已禁用的保护软件。

警告

完成这些步骤后，重新启用任何禁用的保护软件。

以管理员身份运行 Visual C++ Redistributable 安装程序

文件访问失败与权限不足密切相关。

  1. 右键单击 VC Redist 安装程序，然后选择“ 以管理员身份运行”。
  2. 请重试安装。

检查 Windows 的更新

在极少数情况下，过时的系统组件可能会导致安装问题。

  1. 转到 Windows 更新并安装所有挂起的更新。
  2. 重新启动电脑。
  3. 请重试安装。

使用 Visual Studio 安装程序时的常规故障排除步骤

手动安装 Visual C++ Redistributable

注释

当 VC Redist 单独安装时，VS Installer 可能会提示重新启动。

  1. 下载 最新的 VC Redist 安装程序。
  2. 运行 VC Redist 安装程序。
  3. 重试 Visual Studio 安装程序。

如果手动安装失败，请按照 独立 VC Redist 安装程序的常规故障排除步骤。

清除 Visual Studio 安装程序缓存

  1. 打开 %ProgramData%\Microsoft\VisualStudio\Packages。
  2. 删除文件夹中的所有文件以强制 Visual Studio 安装程序重新生成这些文件。
  3. 重试 Visual Studio 安装程序。

修复 Visual Studio 安装程序

  1. 打开 “设置” 应用。
  2. 使用窗口顶部的搜索栏搜索 已安装的应用 。
  3. 搜索 Visual Studio 安装程序。
  4. 单击“...”按钮，然后选择“ 修改”。
  5. 选择“ 修复 Visual Studio 安装程序”选项。
  6. 重试 VS 安装。

删除 Visual Studio Installer 文件夹

警告

此方法要求下载 Visual Studio 安装程序（VisualStudioSetup.exe）。 您可以从https://my.visualstudio.com下载 Visual Studio 安装程序。

此方法有助于防止安装程序元数据损坏，删除安装程序文件夹会强制 Visual Studio 安装程序重新生成它。

  1. 从 https://my.visualstudio.com 下载VisualStudioSetup.exe。
  2. 删除文件夹 C:\Program Files (x86)\Microsoft Visual Studio\Installer，系统可能会提示以管理员身份运行此作。
  3. 运行 VisualStudioSetup.exe。

常见问题

常见错误一目了然

常规安装失败

返回代码 1603 表示安装 Visual C++ 运行时组件期间 Windows Installer 生成的通用安装失败。

由于许多因素可以生成 1603 代码，因此代码本身不提供足够的信息来诊断问题的原因。 通常，VC Redist 安装程序生成的日志文件包含可能导致解决方案或解决方法的相关信息。

“常见问题”部分介绍了如何诊断常见安装错误和可能解决这些错误的步骤的示例。 如果此处找不到问题，请按照说明 在 Visual C++ 可再发行组件安装程序中报告问题。

访问被拒绝

安装失败，错误代码为 5。 此错误代码通常指示权限问题;具体而言，访问被拒绝的问题。

解决的步骤

  1. 暂时禁用防病毒、组策略和防火墙。
  2. 运行 VC Redist 安装程序。
  3. 重新启用任何禁用的保护软件。

如果安装失败，请尝试以管理员身份运行 VC Redist 安装程序。

文件已锁定

安装失败，错误代码为 32。 另一个进程正在使用的文件、防病毒软件、组策略或损坏的文件是常见原因。

解决的步骤

  1. 关闭电脑中运行的任何软件。
  2. 请尝试 常规故障排除步骤中的方法。

如果安装失败，请尝试重启电脑以释放任何锁定的文件。

损坏或无效的安装程序包

安装失败，错误代码为 1620。 此错误代码指示无法打开 Windows Installer 包（MSI），可能是由于损坏或无效文件。

这些错误消息的存在表示缓存已损坏。

  • 错误代码 1620：指示无法打开 Windows Installer 包。
  • 错误代码0x80091007：由于哈希不匹配，多个有效负载验证失败。
  • 错误代码0x80070654：在 MSI 包无法执行时发生。

解决的步骤

使用 Visual Studio 安装程序时，请尝试常规故障排除步骤中的步骤。

无法删除旧版本

安装失败，错误代码为 1714。 此错误代码指示损坏的 Windows Installer 缓存，导致无法删除早期版本的 VC Redist。

这些错误消息的存在表示缓存已损坏。

在 dd_vcredist_<arch>_<timestamp>.log 中

Error 0x80070003: Failed to get size of pseudo bundle: C:\ProgramData\Package Cache\{43d1ce82-6f55-4860-a938-20e5deb28b98}\VC_redist.x64.exe
Error 0x80070003: Failed to initialize package from related bundle id: {43d1ce82-6f55-4860-a938-20e5deb28b98}

在 dd_vcredist_<arch>_<timestamp>_vcRuntimeMinimum_<arch>.log中：

SOURCEMGMT: Trying source C:\ProgramData\Package Cache\{455DF12C-7D43-4EFF-AE2F-43C8AF2817A3}v14.28.29914\packages\vcRuntimeMinimum_amd64\.
Note: 1: 2203 2: C:\ProgramData\Package Cache\{455DF12C-7D43-4EFF-AE2F-43C8AF2817A3}v14.28.29914\packages\vcRuntimeMinimum_amd64\vc_runtimeMinimum_x64.msi 3: -2147287037 
SOURCEMGMT: Source is invalid due to missing/inaccessible package.

Note: 1: 1714 2: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 3: 1612 
CustomAction  returned actual error code 1612 (note this may not be 100% accurate if translation happened inside sandbox)
Product: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 -- Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed.  Contact your technical support group.  System Error 1612.

Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed.  Contact your technical support group.  System Error 1612.

在 VSSetupEvents.txt 中

Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed.  Contact your technical support group.  System Error 1612.] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [(NULL)] []

解决的步骤

在日志文件中，记下导致问题的 VC Redist 版本。

方法 1：使用 Windows Installer。

  1. 尝试使用 Windows Installer 手动删除旧的 VC Redist 版本。 如果出现提示，请让 Windows Installer 疑难解答尝试解决此问题。
  2. 请重试安装。

方法 2：手动删除旧版本。

  1. 下载旧版本的 VC Redist 安装程序。 按照 步骤下载一个旧版的 VC Redist 安装程序
  2. 运行安装程序以卸载旧的 VC Redist。
  3. 请重试安装。

下载 Visual C++ 可再发行组件安装程序的旧版本

警告

从不安装从Microsoft站点下载的 Visual C++ 可再发行组件安装程序。 从不安装未由Microsoft签名的 Visual C++ 可再发行组件安装程序。

从 my.visualstudio.com 下载 VC Redist 安装程序。 在下载页上搜索 Visual C++ Redistributable。

本文提供了每个 Visual Studio 版本支持的最新 VC Redist 版本。

旧版本或遗留版本的链接：

版本范围 下载链接模板 Example
14.50 或更高版本 https://aka.ms/vs/18/release/<version>/VC_redist.<arch>.exe https://aka.ms/vs/18/release/14.50.35719/VC_redist.x64.exe
14.30 到 14.44 https://aka.ms/vs/17/release/<version>/VC_redist.<arch>.exe https://aka.ms/vs/17/release/14.32.31332/VC_redist.arm64.exe
14.20 到 14.29 https://aka.ms/vs/16/release/<version>/VC_redist.<arch>.exe https://aka.ms/vs/16/release/14.28.29914/VC_Redist.x86.exe
14.10 到 14.19 https://aka.ms/vs/15/release/<version>/VC_redist.<arch>.exe https://aka.ms/vs/15/release/14.12.25810/VC_redist.x64.exe

可以通过必应搜索查找旧版本的安装程序。 仅从Microsoft站点下载 VC Redist 安装程序。 仅安装由Microsoft签名的包。

报告 Visual C++ 可再发行组件安装问题

常见问题列表是从通过开发人员社区向Microsoft报告的反馈中收集的。

如果在该部分中找不到问题，或者如果本故障排除指南中的步骤无法解决问题，请使用 “报告问题 ”窗体创建新的反馈项目。

报表必须包含以下有关环境的信息：

  • 尝试安装的 VC Redist 版本。
  • 如果进行升级，请检查以前安装的 VC Redist 的版本。
  • 如果是通过 Visual Studio 安装程序进行安装，则请指定 VS 安装程序的版本。
  • 根据“收集失败日志”部分的步骤收集的日志。

没有此信息（尤其是没有日志）的反馈是不可作的，如果未及时提交其他信息，则可能会关闭。

另请参阅

最新支持的 Visual C++ 可再发行组件下载
Visual Studio 版本之间的 C++ 二进制兼容性
如何审核 Visual C++ 运行时版本使用情况
生命周期常见问题解答 - Visual C++ 可再发行组件库和运行时库

  • Last updated on