安装与运行环境 · Windows

Windows 提示缺少 WebView2:在线安装、离线包与白屏排查

分清 WebView2 Runtime、Edge 浏览器和应用本身,选择官方在线或离线安装包,重启应用验证;白屏仍在时保留配置,按错误阶段继续排查。

微软官方下载 ↗安装后怎样验证

先确认应用是否真的需要 WebView2

应用明确提示“缺少 WebView2 Runtime”,与界面已经打开但订阅导入失败,是两条不同的排查路径。前者先看运行环境;后者应去查订阅下载与格式。只有白屏、闪退或托盘图标,没有明确报错时,先记录应用名称、版本、安装包架构和错误原文,再查该应用的官方安装要求,不能仅凭白屏认定缺少 WebView2。

例如,同一台电脑上浏览器能打开网页,却有某个桌面应用提示缺少运行时:浏览器联网正常,只能排除一部分网络问题,不能证明该应用依赖齐全。先补齐明确缺失的依赖,再判断连接,不必先换订阅或清空节点。

已经安装 Edge,为什么还会提示缺少运行时?

WebView2 把网页界面嵌入桌面应用。生产应用使用的是 WebView2 Runtime,不能把 Edge 稳定版浏览器当作它的替代品。因此“Edge 能打开”与“应用能找到所需 Runtime”不是同一个验证结果。运行时也不会像普通浏览器那样提供桌面快捷方式。

Windows 11 预装 Evergreen Runtime,符合条件的 Windows 10 设备也通常已有它,但微软仍要求应用考虑未安装等例外情况。不要仅根据 Windows 名称跳过检查,也不要因为找不到快捷方式就重复安装。优先看应用的错误信息和官方依赖检测结果。

在线安装器、离线安装包和 Fixed Version 怎么选

从微软 WebView2 下载页进入,先认清三个名称:

下载项适合的情况
Evergreen Bootstrapper小型在线安装器,运行时下载并安装匹配设备架构的 Runtime;需要能连接微软下载服务。
Evergreen Standalone Installer完整离线安装包,提供 x86、x64、ARM64;目标电脑无法完成在线下载时使用。
Fixed Version供应用开发者随软件打包并指定使用的固定版本,不是普通用户双击安装的通用修复包。

普通安装选择 Evergreen;若应用官方明确提供内置运行时的专用包,则遵循该应用的说明,不把一个软件的处理方式套给所有软件。Clash Verge Rev 的安装入口可见对应工具指南,按该项目的说明选择安装包。

下载和安装:一次只处理一个变量

  1. 保存正在编辑的内容,退出报错应用。若有配置导出功能,先备份;界面打不开时不要为找备份而删除未知目录。
  2. 打开微软下载页。网络允许时可用 Bootstrapper;离线包则先在 Windows“设置 → 系统 → 系统信息”查看系统类型,分清 x64 与 ARM64 等架构,再核对应用要求。
  3. 确认下载来自微软,并在运行前核对 Windows 显示的发布者信息。下载失败时保留错误,区分还没取得文件、安装器无法联网、安装过程报错;不从陌生网盘补一个同名程序。
  4. 运行所选安装器并等待完成。如果组织策略阻止安装,交由管理员处理,不通过关闭安全软件、改注册表权限或删除系统组件强行继续。

在线安装器下载途中失败时,完整 Standalone Installer 可以减少目标电脑对在线下载的依赖,但它不能解决应用本身的配置错误,也不保证绕过系统或组织的安装限制。关于安装包内容核对,可再看摘要校验、来源与签名的区别。

安装完成后,验证原来的失败操作

先完全退出并重新打开原应用,而不是只把窗口最小化。微软说明,运行中的 WebView2 应用通常要重启后才使用更新的 Runtime。验证应回到原先失败的位置:是否还提示缺少运行时、主窗口能否正常显示、原操作是否可完成。安装器显示成功,只证明安装步骤结束,不等于整个应用已恢复。

界面恢复后,再单独检查订阅或网络功能。不要把“窗口能打开”写成“节点已连通”;可按客户端、内核与订阅分层确认。如果没有变化,记下安装前后的错误差异,不要连续换几个来源不明的运行时包。

仍然白屏时,怎样保留现场并恢复

若不再提示缺少 Runtime,却仍白屏,调查范围应转向应用版本、它自己的日志和官方故障说明。若错误完全没变,则向维护者提供 Windows 系统类型、应用版本、所选 Evergreen 安装方式、安装器结果和应用错误原文。遮住订阅地址、访问令牌和个人路径;本文没有在你的设备上安装或实测,不能凭同样的表面症状给出唯一原因。

Evergreen Runtime 会被多个应用共享,不应为了回退一个应用就手动删除整个运行时目录。若本次还替换过应用安装包,按应用官方回退方式恢复已备份的程序与配置;如果只安装了运行时且没有改配置,就先保留现状让维护者定位。Fixed Version 则由提供它的应用负责更新,普通用户不应自行把文件塞进其他应用目录。

官方参考