[Docs] Windows 内网缺少 WebView2 Runtime 导致无法启动 — 安装与排查指南

[Syngnat]

背景

GoNavi Windows 桌面版基于 Wails + Microsoft Edge WebView2。
部分用户（尤其是内网环境、精简镜像、Windows Server、LTSC、新装机）系统中没有预装 WebView2 Runtime，会导致应用无法正常打开。

本 Issue 作为官方说明与互助入口，完整教程已写入 README：

• 中文：README.zh-CN.md · 常见问题 · Windows WebView2
• English: README.md · Troubleshooting · Windows WebView2

---

典型症状

• 双击后进程立刻退出 / 窗口一闪而过
• 白屏、空白窗口
• 提示找不到 WebView2 / WebView2 Runtime
• 仅内网机器复现，家里/外网电脑正常

---

解决办法（摘要）

A. 有外网：Evergreen Bootstrapper

1. 打开 Microsoft Edge WebView2 下载页
2. 下载 Evergreen Bootstrapper
3. 管理员身份运行安装 → 重新打开 GoNavi

B. 内网 / 离线：Evergreen Standalone（推荐企业）

Bootstrapper 需要安装时联网，断网环境请用独立安装包：

1. 在能上网的电脑下载对应架构 Standalone Installer
   • 常见：MicrosoftEdgeWebView2RuntimeInstallerX64.exe
2. U 盘 / 软件中心 / 共享目录分发到内网
3. 目标机管理员安装：

.\MicrosoftEdgeWebView2RuntimeInstallerX64.exe /silent /install

4. 再启动 GoNavi；仍异常可注销或重启一次 Windows

C. 如何确认已安装

Test-Path "${env:ProgramFiles(x86)}\Microsoft\EdgeWebView\Application"

Get-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}" `
  -ErrorAction SilentlyContinue |
  Select-Object pv, name

有版本号 pv 或 EdgeWebView 目录存在，一般即已安装。

D. 临时绕过：Web Server + 浏览器

桌面 WebView 短期装不上时，可本机启动实验性 Web Server，用系统浏览器访问（见 README「Web Server」）。不要把未加固入口暴露公网。

---

给 IT / 管理员

项	建议
分发介质	Evergreen Standalone x64（勿只发 Bootstrapper）
静默参数	/silent /install
权限	本地管理员或 SCCM / 软件中心推送
策略	勿禁用 Edge / WebView2 安装与更新
强管控	可评估 Fixed Version Runtime 统一版本

---

仍无法启动时，请在本 Issue 补充

- GoNavi 版本（Release 包名）：
- Windows 版本 / 是否 LTSC / Server：
- 是否内网、能否访问 Microsoft 下载站：
- 已尝试：Bootstrapper / Standalone / 静默安装？
- 上述 PowerShell 检查结果（pv / 路径 True|False）：
- 报错原文或截图（注意脱敏）：

---

状态

• README 中英文 FAQ 已补充
• 视反馈决定是否在启动失败时给出更明确的引导文案 / 下载链接（后续增强）

欢迎在本帖反馈「按文档安装后是否恢复正常」，方便我们持续完善说明。

[yuetao529]

这个得下载哪个版本

[Syngnat]

这个得下载哪个版本

下载这个amd64架构的