Linux IBus 输入法配置文档

适用环境：Ubuntu / Debian / GNOME 桌面环境
输入法引擎：IBus + 五笔（Wubi Jidian 86）

目录

1. 安装 IBus 与输入法引擎
2. 查看已安装的输入法引擎
3. 切换当前输入法引擎
4. 设置系统输入源（持久化配置）
5. 重启 IBus 守护进程
6. 验证配置
7. 常见问题

1. 安装 IBus 与输入法引擎

# 安装 IBus 框架
sudo apt install ibus

# 安装五笔输入法引擎（86版极点五笔）
sudo apt install ibus-table-wubi

# 安装其他常用输入法（可选）
sudo apt install ibus-libpinyin        # 拼音输入法
sudo apt install ibus-table-cangjie    # 仓颉输入法

2. 查看已安装的输入法引擎

# 列出所有可用的 IBus 输入法引擎
ibus list-engine

# 筛选包含 "wubi" 或 "jidian" 的引擎
ibus list-engine | grep -E "wubi|jidian"

示例输出：

table:wubi-haifeng86 - WuBiHaifeng86
table:wubi-jidian86 - WuBi-Jidian-86-JiShuag-6.0

3. 切换当前输入法引擎

临时切换（仅当前会话有效）

# 切换到五笔86版极点五笔
ibus engine table:wubi-jidian86

# 切换到拼音
ibus engine libpinyin

# 切换到美式英文
ibus engine xkb:us::eng

# 查看当前使用的引擎
ibus engine

快捷键切换

默认快捷键：

• Super + Space：切换输入源
• Ctrl + Space：切换输入法开关（启用/禁用中文输入法）

可在 设置 → 键盘 → 输入法 中自定义快捷键。

4. 设置系统输入源（持久化配置）

使用 gsettings 配置 GNOME 输入源

# 查看当前输入源配置
gsettings get org.gnome.desktop.input-sources sources

# 设置输入源（示例：英文 + 拼音 + 五笔）
gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'libpinyin'), ('ibus', 'table:wubi-jidian86')]"

# 仅英文 + 五笔
gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'table:wubi-jidian86')]"

# 仅五笔
gsettings set org.gnome.desktop.input-sources sources "[('ibus', 'table:wubi-jidian86')]"

注意：gsettings 配置是持久的，重启后依然生效。

使用 GUI 配置（GNOME）

1. 打开 设置 → 键盘 → 输入源
2. 点击 + 添加输入源
3. 选择 中文（China） → 找到 五笔（Jidian 86） 添加

5. 重启 IBus 守护进程

修改配置或安装新引擎后，需要重启 IBus 使配置生效：

# 重启 IBus 守护进程（-d 后台运行，-r 重启，-x 替换现有进程）
ibus-daemon -drx

# 或者先杀死旧进程再启动
killall ibus-daemon
ibus-daemon -d

6. 验证配置

# 查看当前的输入源列表
gsettings get org.gnome.desktop.input-sources sources

# 查看当前激活的输入法引擎
ibus engine

# 检查 IBus 守护进程是否在运行
ps aux | grep ibus-daemon

7. 常见问题

7.1 ibus engine 切换失败

问题：运行 ibus engine table:wubi-jidian86 后报错：

IBUS-WARNING: main.vala:145: Execute setxkbmap failed: Cannot open display "default display"

原因：IBus 守护进程未运行或环境变量 DISPLAY 未设置。

解决：

# 先启动 IBus 守护进程
ibus-daemon -drx

# 然后再切换引擎
ibus engine table:wubi-jidian86

7.2 gsettings 配置后不生效

问题：配置了 gsettings 但切换输入法时看不到新引擎。

解决：

1. 确保引擎已安装：ibus list-engine | grep wubi
2. 重启 IBus：ibus-daemon -drx
3. 登出/重新登录 GNOME 会话

7.3 输入源配置格式错误

gsettings set 的数组格式必须严格使用单引号包裹每个元组：

# 正确 ✅
gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'table:wubi-jidian86')]"

# 错误 ❌（缺少引号）
gsettings set org.gnome.desktop.input-sources sources "[('xkb', 'us'), ('ibus', 'wubi')]"

('ibus', 'wubi') 是旧版配置写法，新版需要用完整的 engine 名称如 table:wubi-jidian86。

附录：常用 IBus 命令速查

文档生成日期：$(date +%Y-%m-%d)