Arch Linux KDE Wayland 下 WPS Office 无法双击打开 doc/docx 文件的排查与解决
环境信息
| 项目 | 版本 |
|---|---|
| 系统 | Arch Linux (CachyOS) |
| 桌面环境 | KDE Plasma (Wayland) |
| WPS Office | 12.1.2.25838 (wps-office-cn) |
| WPS 自带 Qt | 5.12.12 (魔改版，库名带 Kso 后缀) |
问题现象
在 KDE Plasma Wayland 桌面环境下，双击 .doc / .docx 文件时，WPS 编辑器无任何反应，文件无法打开。
在终端中手动运行 WPS 可看到以下错误信息：
qt.qpa.plugin: Could not find the Qt platform plugin "wayland" in ""
进程退出码为 255。
排查过程
1. 检查文件关联
通过 xdg-mime 查询 MIME 类型关联：
xdg-mime query default application/msword
# 输出：wps-office-wps.desktop
xdg-mime query default application/vnd.openxmlformats-officedocument.wordprocessingml.document
# 输出：wps-office-wps.desktop
文件关联配置正确，.doc 和 .docx 均指向 WPS。
2. 检查依赖库
ldd /usr/lib/office6/wps | grep "not found"
没有缺失的动态库，所有依赖均正常。
3. 命令行直接启动定位错误
/usr/lib/office6/wps 2>&1
输出大量 qt.qpa.plugin: Could not find the Qt platform plugin "wayland" in "" 错误，确认是 WPS 自带的 Qt 找不到 Wayland 平台插件导致无法启动。
4. 分析 WPS 自带的 Qt 环境
查看 WPS 的 Qt 插件目录：
find /usr/lib/office6/qt/plugins/platforms -type f
输出：
/usr/lib/office6/qt/plugins/platforms/libqxcb.so
只有 XCB (X11) 平台插件，没有 Wayland 插件。
查看 WPS 自带 Qt 的库名：
ls /usr/lib/office6/libQt5CoreKso.so
ls /usr/lib/office6/libQt5GuiKso.so
WPS 使用的是魔改版 Qt 5.12，库名均带 Kso 后缀（如 libQt5CoreKso.so），与系统标准 Qt 5.15 的 libQt5Core.so 完全不同。
踩坑记录
坑 1：安装 qt5-wayland / qt6-wayland — 无效
sudo pacman -S qt5-wayland qt6-wayland
安装后问题依旧。
原因：系统安装的 Qt Wayland 插件是为标准 Qt 5.15 编译的，链接的是 libQt5Core.so.5、libQt5Gui.so.5 等标准库名。而 WPS 自带的是魔改版 Qt 5.12，库名为 libQt5CoreKso.so，ABI 完全不兼容，WPS 无法加载系统的 Wayland 插件。
坑 2：复制系统 Wayland 插件到 WPS 目录 — 不可行
尝试将 /usr/lib/qt/plugins/platforms/libqwayland-generic.so 复制到 /usr/lib/office6/qt/plugins/platforms/。
原因：该插件还依赖 libQt5WaylandClient.so.5，而 WPS 根本没有这个库。即使复制插件也无法加载，缺少整个 Wayland Client 运行时。
坑 3：从 WPS 官方 deb 包提取 Wayland 插件 — 官方没有打包
解包 WPS 官方 deb 查看：
ar p wps-office_12.1.2.25838_amd64.deb data.tar.xz | tar tJf - | grep platforms/
输出仅包含：
./opt/kingsoft/wps-office/office6/qt/plugins/platforms/libqxcb.so
官方包中也只有 libqxcb.so，WPS 官方根本没有为 Linux 版编译 Wayland 平台插件。
坑 4：设置 QT_QPA_PLATFORM=xcb 强制 X11 — 能用但有副作用
在 /usr/bin/wps 中添加 export QT_QPA_PLATFORM=xcb 可以让 WPS 启动，但会通过 XWayland 兼容层运行，存在高分屏缩放模糊、输入法兼容性等问题。
原理解释
WPS Office Linux 版自带了一套魔改的 Qt 5.12 运行时（库名统一加了 Kso 后缀以避免与系统 Qt 冲突）。这套魔改 Qt 的核心库（libQt5GuiKso.so）虽然包含了 Wayland 的识别代码，但 WPS 没有编译和打包以下关键组件：
- Qt5WaylandClient 库（Wayland 客户端协议实现）
libqwayland-generic.so（Wayland 平台插件）
因此 WPS 在 Wayland 会话中启动时，Qt 检测到当前是 Wayland 环境并尝试加载 wayland 平台插件，但在自己的插件目录中找不到，导致启动失败。
WPS 的“整合模式”窗口管理会在启动时创建一个总的窗口容器来管理所有子窗口，这个过程需要在程序启动的最初阶段就完成平台插件的加载，因此一旦 Wayland 插件缺失就直接崩溃退出。
最终解决方案
不需要安装任何额外的包，也不需要修改启动脚本。
只需在 WPS 设置中切换窗口管理模式即可：
- 打开 WPS Office（可从开始菜单打开，或终端执行
wps） - 进入 设置
- 点击 切换窗口模式
- 将窗口管理模式从 整合模式 切换为 多组件模式
- 重启 WPS 生效
切换后，双击 .doc / .docx 文件即可正常用 WPS 打开。
说明：多组件模式下，WPS 文字、表格、演示各自以独立窗口运行，不再依赖整合模式的窗口容器管理，从而绕开了 Wayland 平台插件缺失导致的启动问题。