Lively Wallpaper 故障排查指南：动态壁纸不显示、黑屏、配置报错一次修好
【免费下载链接】livelyFree and open-source software that allows users to set animated desktop wallpapers and screensavers powered by WinUI 3.项目地址: https://gitcode.com/gh_mirrors/li/lively
Lively Wallpaper 装好了动态壁纸却不播？九成是媒体文件路径失效、播放器组件缺失或配置文件损坏。按这份故障排查清单从最可能的原因查起，10 分钟内能定位并修好。
| 你看到的现象 | 大概率原因 | 看哪一节 |
|---|---|---|
| 壁纸在列表里正常，桌面却还是静态图 | 媒体文件被移动/删除，或暂停规则生效 | 『列表正常，桌面还是静态图』 |
| 打开视频或网页壁纸后黑屏、报错 | 缺少 mpv 播放器或 WebView2 运行时 | 『打开后黑屏，缺了什么组件』 |
| 改过 Settings.json 后程序异常、设置不保存 | 配置文件损坏 | 『改坏 Settings.json 怎么恢复』 |
| 多屏下一块屏黑屏或副屏没声音 | 多屏策略的预期行为，非故障 | 『副屏黑屏是没声音是故障吗』 |
为什么壁纸列表里正常，桌面却还是静态图？
确认现象。Lively 主窗口的 Library 里条目在、缩略图正常，但桌面停在旧静态壁纸上。打开%LocalAppData%\Lively Wallpaper\logs下最新日志，能看到类似Skipping wallpaper, file xxx not found的记录。
解释原因。Lively 按绝对路径引用壁纸文件（记录在各自的LivelyInfo.json里）。视频文件被移动、改名或删除后路径失效，这张壁纸会被直接跳过——这是动态壁纸不显示的头号原因。另一种可能是暂停规则在正常工作：全屏应用运行时暂停、电池供电时暂停，桌面看起来"没在播"，其实不是故障。
具体动作。先在 Library 里双击该条目预览：能播，就把媒体文件拖回库中重新添加（别试图找回旧条目）；不能播，先把媒体文件恢复回原路径。再去设置页检查 "Applications fullscreen" 和电池相关选项，不需要暂停就改成继续播放。
怎么判断修好了。设置后桌面立刻动起来，日志不再出现file not found，暂停行为符合预期。
视频或网页壁纸打开后黑屏，缺了什么组件？
确认现象。视频、GIF 或网页壁纸打开后黑屏、报错，提示 "Wallpaper player not found"，或网页壁纸反复出现WallpaperWebView2NotFoundException。
解释原因。视频壁纸依赖自带的 mpv 播放器，固定读取安装目录下plugins\mpv\mpv.exe；网页类壁纸（web、url、Shadertoy）依赖系统的 WebView2 运行时。安装包文件不全——被安全软件隔离、解压不完整——缺的就是这两样。
具体动作。⚠️ 别把 release 压缩包当绿色版直接跑。卸载旧版本，用官方安装包重装（需 Windows 10 1903 以上）；装完确认安装目录存在plugins\mpv\mpv.exe；网页壁纸另装 "Microsoft Edge WebView2 Runtime"。
怎么判断修好了。视频壁纸设置后立即起播，网页壁纸几秒内完成加载，不再报错。
改坏 Settings.json 之后，配置文件怎么恢复？
确认现象。Lively 启动失败，或刚改的设置立刻打回原形。注意：首次运行时日志里File not found for ..., creating default at ...属于正常现象，程序会自动重建；只有"手动改过的文件"之后行为异常才算问题。
解释原因。Settings.json、WallpaperLayout.json、AppRules.json都在%LocalAppData%\Lively Wallpaper\下。手动编辑后保存了非法 JSON，程序读取失败，行为随之失控，这是配置报错的主要来源。
具体动作。完全退出 Lively，把出问题的 JSON 从该目录移到桌面留底（移动，不是删除），再启动程序。缺失的文件会按默认值重建，设置回到初始状态，回应用内设置页重新配置即可。各配置文件路径的定义可查 Constants.cs。
怎么判断修好了。程序正常启动，目录中生成了新的 JSON，设置页的改动重启后依然保留。
多显示器下副屏黑屏或没声音，是故障吗？
确认现象。接两块以上显示器时，某块屏是黑的，或副屏上的壁纸没有声音。
解释原因。这是 Lively 的多屏策略，不是故障：主屏保留音量，副屏一律静音；某块显示器在WallpaperLayout.json布局里找不到对应条目时，程序会直接贴一块黑屏窗口上去保护屏幕。所以"副屏没声音""某块屏黑着"属于预期行为。
具体动作。想让副屏出内容，在主窗口里为该屏单独选择壁纸并按 Per display 方式应用；或改用 Span 让同一张壁纸铺满所有屏。
怎么判断修好了。每块屏显示你指定的壁纸，音量只在主屏——这就是正确终态，不用继续修。
先别做这些
- 别整目录删除
%LocalAppData%\Lively Wallpaper。库和布局配置会全丢，要重建；正确做法是移动单个问题文件并留底。 - 别反复重新下载安装。组件缺失的问题重装同样姿势也修不好，先看
logs里最后 20 行日志。 - 别直接复制 release 压缩包当绿色版运行，mpv / WebView2 组件不全正是黑屏首因。
- 别在 Lively 运行时改 JSON，改完也别用错误编码保存，否则好文件也会被改坏。
验收清单
%LocalAppData%\Lively Wallpaper目录存在，Settings.json、WallpaperLayout.json可读- 目标媒体文件仍在原路径，Library 里预览能正常播放
- 安装目录存在
plugins\mpv\mpv.exe（视频壁纸必需） - 设置壁纸后桌面是动态的，且不再退回静态图
- 多显示器时每块屏的显示符合你选定的布局（主屏有声、副屏静音属正常）
全部打勾后只做一件事：在 Lively 主窗口选中目标壁纸，点 Set 应用。3 秒内桌面动起来，排查结束；仍不起来，回到『列表正常，桌面还是静态图』一节逐行核对日志。
FAQ
重启系统后壁纸要重新设置吗？不用，Lively 启动时会恢复上次的布局；恢复不了一般是WallpaperLayout.json的问题，移动该文件让其重建。
日志到底看哪个文件？%LocalAppData%\Lively Wallpaper\logs里最新一份，每张壁纸的加载结果和原因都有记录。
Microsoft Store 版也一样吗？Store 版运行在受限沙箱里，程序类壁纸等功能受限，遇到限制建议改用官方独立安装包。
【免费下载链接】livelyFree and open-source software that allows users to set animated desktop wallpapers and screensavers powered by WinUI 3.项目地址: https://gitcode.com/gh_mirrors/li/lively
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
