Ubuntu 24.04 中 IBus 输入法无法启动或候选框不显示？

Question

在 Ubuntu 24.04（基于 GNOME 46 + Wayland 默认会话）中，IBus 输入法常出现「完全无法启动」或「输入时无候选框弹出」的问题。典型表现为：`ibus-daemon` 进程未运行、`ibus-panel` 不显示托盘图标、中文/日文等输入法切换后仅输出英文字符、候选窗口空白或闪退。根本原因多为环境变量缺失（如 `GTK_IM_MODULE=ibus`、`QT_IM_MODULE=ibus`、`XMODIFIERS=@im=ibus` 未正确设置）、GNOME 的输入源配置与 IBus 冲突（如系统设置中启用了“GNOME 原生输入法”而非 IBus）、Wayland 下部分应用（如 VS Code、Electron 应用）对 IBus 支持不完善，或 IBus 配置损坏（`~/.config/ibus/` 权限异常或 `bus_address` 错误）。此外，升级后残留旧版 `ibus-libpinyin` 或 `ibus-pinyin` 包亦可能引发兼容性问题。该问题非单纯重启 IBus 可解，需结合会话类型、环境变量、GNOME 设置及输入法后端协同排查。

Answer 1

```html

一、现象层：识别典型故障表征

• ps aux | grep ibus-daemon 返回空结果 → 守护进程未启动
• GNOME 顶部栏无 IBus 图标（托盘缺失），ibus-panel 进程不存在
• 切换至「Chinese (Intelligent Pinyin)」后，键入仅输出 ASCII 字符，无候选框弹出
• 候选窗口短暂闪现后空白/崩溃，journalctl -u ibus --since "1 hour ago" 显示 Failed to connect to bus: No such file or directory
• VS Code / Slack / Discord（Electron 应用）中完全无法激活中文输入，但终端（GNOME Terminal）正常

二、环境层：验证 Wayland 会话与核心环境变量

Ubuntu 24.04 默认启用 GNOME 46 + Wayland，IBus 在 Wayland 下依赖 D-Bus session bus 和正确 IM 模块绑定。执行以下诊断：

echo $XDG_SESSION_TYPE        # 应输出 'wayland'
echo $GTK_IM_MODULE            # 必须为 'ibus'（非 'gtk-im-context-simple'）
echo $QT_IM_MODULE             # 必须为 'ibus'
echo $XMODIFIERS               # Wayland 下可忽略，但 Electron 应用仍可能读取（应为 '@im=ibus'）
dbus-run-session -- bash -c 'echo $DBUS_SESSION_BUS_ADDRESS'  # 验证 D-Bus 地址有效性

三、配置层：GNOME 输入源策略与 IBus 后端协同

配置项	正确值	错误风险
Settings → Keyboard → Input Sources	添加「Chinese → Intelligent Pinyin」（非「GNOME Chinese」原生源）	若启用「GNOME Chinese (native)」，将绕过 IBus，导致 ibus-daemon 被抑制
gsettings get org.gnome.settings-daemon.plugins.input-sources active	包含 'ibus' 字符串	返回空数组或不含 ibus → GNOME 层未委托输入控制权

四、状态层：检查 IBus 运行时健康度与配置完整性

执行以下链式诊断命令：

# 1. 强制重置并启动（Wayland 兼容模式）
ibus restart --no-daemon --xim &
# 2. 检查配置目录权限（关键！Ubuntu 24.04 升级常导致 ~/.config/ibus 权限为 root）
ls -ld ~/.config/ibus && ls -l ~/.config/ibus/
# 3. 验证后端模块加载（libpinyin v2.0+ 与 Ubuntu 24.04 内核 ABI 兼容性）
ibus engine --list | grep -E "(pinyin|libpinyin|mozc)"

五、修复层：系统级协同修复方案（含代码与流程图）

推荐按顺序执行以下操作（适用于生产环境部署脚本）：

#!/bin/bash
# Ubuntu 24.04 IBus 深度修复脚本（Wayland 适配版）
set -e
sudo apt install --reinstall ibus ibus-libpinyin ibus-mozc -y
gsettings set org.gnome.settings-daemon.plugins.input-sources sources "[('ibus', 'com.github.mozc-dev.mozc'), ('ibus', 'org.freedesktop.ibus.libpinyin')]"
mkdir -p ~/.config/ibus
chown $USER:$USER ~/.config/ibus
rm -f ~/.config/ibus/bus_address
ibus restart --no-daemon --xim &
sleep 2
ibus engine libpinyin 2>/dev/null || echo "⚠️  libpinyin 未就绪，尝试回退至 pinyin"

graph TD
  A[启动诊断] --> B{ibus-daemon 是否运行？}
  B -->|否| C[检查 DBus session bus]
  B -->|是| D[检查 GTK/QT_IM_MODULE]
  C --> E[执行 dbus-run-session ibus-daemon -r -d]
  D --> F{候选框是否出现？}
  F -->|否| G[验证 ~/.config/ibus 权限 & bus_address]
  F -->|是| H[确认应用是否支持 Wayland IM]
  G --> I[重置 ibus 配置目录]
  I --> J[重启 GNOME Session]

六、兼容层：Electron/VS Code 等特殊应用的绕过策略

• VS Code：在 settings.json 中添加 "editor.quickSuggestions": {"other": true, "comments": false, "strings": false}, "editor.suggest.snippetsPreventQuickSuggestions": false 并启用 Ctrl+Space 手动触发
• Electron 应用：启动时强制注入环境变量：env GTK_IM_MODULE=ibus QT_IM_MODULE=ibus XMODIFIERS=@im=ibus electron .
• 全局生效：将环境变量写入 /etc/environment（需重启会话）或用户级 ~/.pam_environment（Wayland 推荐）

七、根因层：Ubuntu 24.04 升级残留引发的模块冲突

常见冲突组合：

• ibus-pinyin（已废弃，仅兼容 GTK2）与 ibus-libpinyin（GTK3+/Wayland 原生）共存 → 卸载前者：sudo apt remove ibus-pinyin
• fcitx5 与 ibus 同时安装 → D-Bus 名称冲突，busctl --user list-names | grep org.freedesktop.IBus 应仅返回一个
• libpinyin-data 版本低于 2.7.0 → 导致候选词引擎初始化失败，需升级至 libpinyin-data 2.8.0-1ubuntu1（Ubuntu 24.04 默认源已修复）

```