ibus

Linux 桌面版安装与配置 IBus 中文输入法

补充说明

IBus（Intelligent Input Bus）是 Linux 桌面环境下广泛使用的输入法框架，是 GNOME 桌面环境的默认输入法框架，支持拼音、五笔、双拼、仓颉、Rime 等多种输入方式。

安装前准备

开始安装前，请确保系统已安装桌面环境（GNOME、KDE、XFCE 等）并已更新软件源。

# 更新软件源
sudo apt update          # Debian/Ubuntu
sudo pacman -Sy          # Arch Linux
sudo dnf check-update    # Fedora

安装 IBus

Debian / Ubuntu / Linux Mint

# 安装 ibus 主程序和拼音输入引擎
sudo apt install ibus ibus-libpinyin ibus-gtk3 ibus-qt4

# 安装词库和配置工具
sudo apt install ibus-table ibus-clutter ibus-googlepinyin

Arch Linux / Manjaro

# 安装 ibus 和中文输入引擎
sudo pacman -S ibus ibus-libpinyin ibus-qt

# 安装五笔（可选）
sudo pacman -S ibus-table-chinese

Fedora

# 安装 ibus 和中文输入引擎
sudo dnf install ibus ibus-libpinyin ibus-gtk3 ibus-qt

# 安装五笔（可选）
sudo dnf install ibus-table-chinese

openSUSE

# 安装 ibus 和中文输入引擎
sudo zypper install ibus ibus-libpinyin ibus-gtk ibus-qt

切换 IBus 输入法

# 1. 指定使用 ibus 输入法
im-config -n ibus

# 2. 写入兼容的环境变量
cat << 'EOF' >> ~/.profile
export XMODIFIERS=@im=ibus
export GTK_IM_MODULE=ibus
export QT_IM_MODULE=ibus
export SDL_IM_MODULE=ibus
EOF
cat << 'EOF' >> ~/.xprofile
export XMODIFIERS=@im=ibus
export GTK_IM_MODULE=ibus
export QT_IM_MODULE=ibus
export SDL_IM_MODULE=ibus
EOF

# 3. 设置 IBus 开机自启
mkdir -p ~/.config/autostart
cp /usr/share/applications/ibus.desktop ~/.config/autostart/

配置 IBus

运行配置工具进行图形化配置：

# 启动 ibus 配置界面
ibus-setup

基本配置步骤：

1. 添加输入法：切换到「输入法」选项卡 → 点击「添加」→ 搜索 libpinyin 或 pinyin 选择添加
2. 设置切换快捷键：在「常规」选项卡中设置切换快捷键（默认 Ctrl+Space）
3. 开启系统托盘图标：在「常规」选项卡中勾选「在系统任务栏中显示输入法」
4. 候选词设置：在「输入法」选项卡中选择已添加的输入法 → 点「齿轮」图标调整候选词数量、模糊音等

使用 IBus

# 手动启动 ibus（如果未设置自启）
ibus-daemon -drx

# 重启 ibus
ibus restart

# 查看 ibus 是否运行
ibus-daemon --version
ps aux | grep ibus

常用快捷键：

故障排除

IBus 无法启动或输入法不生效：

# 1. 检查环境变量是否正确设置
echo $GTK_IM_MODULE
echo $QT_IM_MODULE
echo $XMODIFIERS

# 2. 重启 ibus
ibus restart

# 3. 重新启动 ibus 守护进程
ibus-daemon -drx

# 4. 清除 ibus 缓存并重启
ibus-daemon --kill
rm -rf ~/.config/ibus
ibus-daemon -drx

在特定应用中无法输入中文：

• Electron 应用（VS Code、Chrome 等）：

  # 在 ~/.bashrc 中添加
  export ELECTRON_USE_WAYLAND=0
  

• GTK 应用：确认已安装 ibus-gtk3（GTK3）和 ibus-gtk（GTK2）
• Qt 应用：确认已安装 ibus-qt4 或 ibus-qt

候选词不显示中文：

• 确保在 ibus-setup 中正确添加了拼音输入法
• 检查是否已安装中文字体：sudo apt install fonts-noto-cjk

卸载 IBus

# Debian/Ubuntu
sudo apt remove ibus ibus-libpinyin
sudo apt autoremove

# Arch Linux
sudo pacman -R ibus ibus-libpinyin

# Fedora
sudo dnf remove ibus ibus-libpinyin

参考资料

• IBus 官方网站
• IBus Arch Wiki