Fcitx5 + Edge + KDE Wayland 输入法踩坑记录
环境
- 系统: Debian 13 (trixie), KDE Plasma 6.3.6, KWin 6.3.6
- 显示协议: Wayland
- 浏览器: Microsoft Edge 150.0.4078.83 (deb 安装)
- 输入法: fcitx5 + rime
探索轨迹（按时间顺序）
第 1 轮：猜参数
现象：Edge 打不出中文，其他 App 正常。 猜：缺启动参数。
尝试：
--gtk-version=4→ 没用。Edge 的 UI 部分 (地址栏、菜单) 用 GTK，但网页内容 IME 走 Chromium 自己的 IME 栈，不归 GTK 管。--ozone-platform=wayland --enable-wayland-ime→ 还是没用。--gtk-version=4换成--ozone-platform=wayland→ 没用。
此时以为是参数不对，不断换方案。
第 2 轮：怀疑环境变量
猜：GTK_IM_MODULE=fcitx 跟 Wayland 冲突。
操作：
- 建
~/.config/environment.d/fcitx5.conf清掉GTK_IM_MODULE - 在
~/.config/gtk-3.0/settings.ini和~/.gtkrc-2.0加gtk-im-module=fcitx - 登出重进 → 还是没用
结论：Edge 压根不用 GTK 路径，环境变量纯属混淆项。
第 3 轮：怀疑 Edge 不支持 flags.conf
试 ~/.config/microsoft-edge-stable-flags.conf → Edge 进程命令行没读到这些参数，Edge 可能不支持这文件。
第 4 轮：搜到官方文档
https://fcitx-im.org/wiki/Using_Fcitx_5_on_Wayland#KDE_Plasma
官方给出的 KDE Plasma 最佳实践：
| 步骤 | 内容 |
|---|---|
| KDE 版本 | 5.27+ |
| 环境变量 | 只设 XMODIFIERS=@im=fcitx |
| 虚拟键盘 | 系统设置 → 虚拟键盘 → 选 Fcitx 5 |
| Edge 参数 | --enable-features=UseOzonePlatform --ozone-platform=wayland --enable-wayland-ime |
| ⚠ | 不要手动重启 fcitx5（pkill / 托盘重启都不行） |
第 5 轮：被自己坑了
我手动执行了 pkill fcitx5 和 /usr/bin/fcitx5 -d 来重启 fcitx5。
官方文档明确说：
"If you launch fcitx this way (via Virtual Keyboard KCM), make sure you do not use 'restart' in the tray menu, since the socket passed from KWin can not be reused with the newly restarted fcitx."
KWin 启动 fcitx5 时会传一个 Wayland socket 给它，手动重启后 socket 就断了，text-input-v3 协议整个走不通。分步试配置 + 重启 fcitx5 = 两件事互相搞死。
第 6 轮：最终生效
直接去 KDE 系统设置→虚拟键盘→选 Fcitx 5，即时生效，不需要登出。
关键链条
Edge (Wayland)
↓ text-input-v3 协议
KWin (合成器)
↓ zwp_input_method_v1/v2 协议
fcitx5 (输入法后端)三个环节缺一不可：
- Edge 必须走 Wayland 模式：
--ozone-platform=wayland --enable-wayland-ime - KWin 必须有输入法后端：系统设置→虚拟键盘→Fcitx 5
- fcitx5 必须由 KWin 启动（不要手动重启）
踩坑汇总
| 坑 | 为什么错 |
|---|---|
--gtk-version=4 | 网页内容 IME 不走 GTK，走 Chromium IME 栈 |
改 GTK_IM_MODULE 环境变量 | Edge 不在乎这变量，改它纯属干扰 |
~/.config/*-flags.conf | Edge 可能不支持这个 Chromium 特性 |
environment.d 设 CHROME_EXTRA_FLAGS | systemd 环境注入对 KDE 菜单启动不生效 |
手动 pkill fcitx5 / fcitx5 -d | KWin 传的 socket 断了，text-input 协议全废 |
| 只改配置文件不去 GUI | 可能配置文件格式不对或缺字段，GUI 操作最可靠 |
| 登出重进 | 其实不需要，虚拟键盘改了即时生效 |
最终解决方案（一句话）
系统设置 → 键盘 → 虚拟键盘 → 选「Fcitx 5」，Edge 桌面文件 Exec 行加
--enable-features=UseOzonePlatform --ozone-platform=wayland --enable-wayland-ime，不要手动重启 fcitx5。
其他有用的诊断命令
# 查看 Edge 版本
microsoft-edge-stable --version
# 检查 fcitx5 运行状态
pgrep -a fcitx5
# fcitx5 诊断（完整环境检查）
fcitx5-diagnose
# 检查 Edge 是否识别参数（搜二进制中的 flag 名称）
strings /opt/microsoft/msedge/msedge | grep -i "wayland-ime\|ozone-platform\|text-input"
# 看 KWin 输入法配置
cat ~/.config/kwinrc | grep -A2 '\[Wayland\]'
cat ~/.config/kcminputrc | grep -A2 '\[Keyboard\]'