安装问题与解决办法

1 系统要求

Lycia Player 主要面向 Windows 10 / Windows 11 x64。软件基于系统 WebView2 Runtime 显示界面，绝大多数 Windows 10 / 11 电脑已经自带或通过系统更新安装了 WebView2。

如果你的系统是精简版、企业管控环境、长期离线环境，或者曾经手动卸载/清理过 Microsoft Edge 相关组件，就可能缺少 WebView2，或者 WebView2 状态异常。

2 推荐安装方式

1. 前往 下载页 下载最新版安装包。
2. 优先使用文件名中带 setup.exe 的安装包。
3. 双击安装包并按提示安装。
4. 如果系统提示未知发布者，可选择“更多信息”后继续运行。

如果安装过程中被安全软件拦截，请确认安装包来源为本站或 GitHub Releases 后再放行。

3 WebView2 安装失败

旧版安装包可能会在安装时自动下载并安装 WebView2。如果你的电脑已经安装过 WebView2，或者系统中的 WebView2/EdgeUpdate 状态异常，安装器可能停在这一步并显示类似错误：

Failed to install WebView2! The app can't run without it.
Error: Installing WebView2 failed with exit code -2147219700

这个问题通常不是 Lycia Player 主程序损坏，而是安装器在重复调用 Microsoft WebView2 安装程序时失败。

解决办法

1. 关闭当前安装器。
2. 重新下载最新版 Lycia Player 安装包。
3. 重新运行安装包。

新版安装包会跳过 WebView2 下载/安装步骤，不会因为 WebView2 安装程序返回错误而中断 Lycia Player 的安装。

4 安装成功但软件打不开

如果安装成功后软件无法启动、打开后立刻退出，可能是系统确实缺少 WebView2 Runtime。

请从 Microsoft 官方页面安装 Evergreen Standalone Installer：

Microsoft Edge WebView2 Runtime 下载页面

1. 打开上面的 Microsoft 官方链接。
2. 选择 Evergreen Standalone Installer。
3. 选择与你系统匹配的架构。普通 64 位 Windows 选择 x64。
4. 安装完成后，重新打开 Lycia Player。

5 已经安装 WebView2 仍然报错

如果你确认 WebView2 已安装，但旧版安装包仍然提示安装 WebView2 失败，优先使用最新版 Lycia Player 安装包。新版安装包不会再重复安装 WebView2。

如果软件仍然无法启动，可以尝试：

1. 在 Windows 设置中搜索并修复 Microsoft Edge WebView2 Runtime。
2. 更新 Microsoft Edge。
3. 安装 Microsoft 官方 WebView2 Evergreen Standalone Installer。
4. 重启电脑后再运行 Lycia Player。

6 企业电脑、精简系统或离线环境

部分公司电脑会限制 Microsoft EdgeUpdate、PowerShell 下载、运行时安装或注册表写入。精简系统也可能移除了 WebView2 相关组件。遇到这类情况时：

• 优先使用最新版 Lycia Player 安装包，避免安装器联网下载 WebView2。
• 如果应用无法启动，请让管理员安装 Microsoft WebView2 Runtime。
• 离线电脑可先在其他电脑下载 WebView2 Evergreen Standalone Installer，再拷贝到目标电脑安装。

7 重新安装建议

如果你之前安装过旧版，通常可以直接安装新版覆盖。若仍然异常，可以按下面步骤处理：

1. 退出 Lycia Player。
2. 在 Windows “应用和功能”中卸载旧版 Lycia Player。
3. 重新运行最新版安装包。

除非你明确想清空音乐库、播放记录和设置，否则不要随意删除应用数据目录。

8 仍然无法解决

如果以上方法都无法解决，请前往 GitHub Issues 反馈，并尽量附上以下信息：

• Windows 版本，例如 Windows 10 22H2 或 Windows 11 23H2。
• 安装包文件名和 Lycia Player 版本号。
• 错误截图或完整错误文字。
• 是否为公司电脑、精简系统、离线系统或安全软件拦截环境。
• 是否已经安装 Microsoft Edge WebView2 Runtime。