VocoType
故障排查

WebView2 安装失败

解决 VocoType 启动时报错"Failed to install WebView2",手动下载安装 Edge WebView2 Runtime 离线包。

如果启动 VocoType 时遇到以下错误,或双击后软件无反应:

WebView2缺失错误提示

原因

系统缺少 Edge WebView2 Runtime 运行环境。Windows 11 通常自带,但 Windows 10 或精简版系统可能需要手动安装。

解决步骤

1. 访问微软官方下载页

🔗 微软 WebView2 下载页

2. 选择正确的安装包(关键!)

进入页面后,不要点击最上面的「获取链接」或「下载引导程序」。

向下滚动,找到 常青独立安装程序 (Evergreen Standalone Installer) 栏目:

WebView2下载页面指引
选择说明
✅ 常青独立安装程序离线完整包,约 140MB,推荐
❌ 常青引导程序仅 2MB,需联网,易失败

3. 选择正确的版本下载

在「常青独立安装程序」下方,根据你的系统选择对应版本:

版本适用场景
x64绝大多数电脑(Intel/AMD/海光/兆芯 台式机、笔记本)
x86老旧 32 位系统(现在很少见)
ARM64Surface Pro X、骁龙笔记本等 ARM 处理器设备

💡 不确定选哪个?Win + Pause 打开系统信息,查看「系统类型」:显示「x64」选 x64,显示「ARM」选 ARM64。

4. 安装并重启

  1. 下载得到 MicrosoftEdgeWebView2RuntimeInstallerX64.exe 文件
  2. 右键以管理员身份运行
  3. 等待安装完成(安装过程无弹窗,完成后窗口自动消失)
  4. 重新打开 VocoType

常见问题

下载很慢或没反应?

尝试使用手机热点下载,或联系技术支持获取安装包。

电脑无法上网(内网环境)?

用能上网的电脑下载 140MB 的安装包,通过 U 盘拷贝到目标电脑安装。

提示「已有更高版本」?

说明环境已存在,请重启电脑。若仍报错,可能是杀毒软件拦截,暂时退出杀毒软件后重试。