WinGet安装报错“安装程序哈希不匹配”:哈希更新与URL来源咨询
WinGet「安装程序哈希不匹配」问题解答
哈希更新的位置
- 普通用户:无法自行更新哈希值。WinGet的软件包哈希存储在Microsoft社区软件源的应用清单中,你只能提交问题反馈给该源的维护团队,或者等待他们更新清单里的哈希。
- 包维护者/开发者:找到对应应用的
manifest.yaml或manifest.json清单文件,修改其中的InstallerSha256字段为新安装包的哈希值,然后提交PR到Microsoft Community Repository仓库即可完成更新。
WinGet安装包的URL来源
WinGet默认使用的是Microsoft官方维护的社区软件源,每个应用的清单文件里都指定了对应的安装包下载URL,这些URL一般是应用开发者提供的官方下载地址,微软商店类应用的URL则指向微软商店的分发服务器。
相关问题(原GitHub Issue #714 中文翻译)
大量用户反馈,使用WinGet安装多款应用时频繁触发「安装程序哈希不匹配」错误,但这些应用在微软商店或官方渠道均可正常安装。
常见诱因:
- 应用开发者更新了安装包,但未同步更新WinGet清单中的哈希值
- CDN缓存差异,导致下载的安装包版本与清单记录不符
临时解决办法:
- 直接前往应用官网下载安装包手动安装
- 执行
winget install --id IDHERE --force跳过哈希校验(⚠️ 注意:此操作会绕过安全校验,仅在完全信任安装源时使用)官方后续优化方向:
- 缩短应用清单的更新同步周期,减少哈希不匹配的滞后时间
- 优化哈希校验失败时的提示信息,引导用户提交反馈或使用临时方案
内容的提问来源于stack exchange,提问作者Tom
相关产品推荐
相关产品推荐

