fcitx5

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

补充说明

Fcitx5 是 Linux 桌面环境下一款现代化的输入法框架，是 Fcitx4 的重写版本，支持拼音、五笔、双拼、仓颉等多种输入方式，具有更好的性能、更现代化的架构和更美观的界面。

安装前准备

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

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

安装 Fcitx5

Debian / Ubuntu / Linux Mint

# 安装 fcitx5 主程序和拼音输入引擎
sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt5

# 安装词库和配置工具
sudo apt install fcitx5-pinyin-zhwiki fcitx5-module-cloudpinyin fcitx5-material-color

# 安装五笔（可选）
sudo apt install fcitx5-table-wubi

Arch Linux / Manjaro

# 安装 fcitx5 和中文输入引擎
sudo pacman -S fcitx5 fcitx5-chinese-addons fcitx5-qt fcitx5-gtk fcitx5-config-qt

# 安装词库
sudo pacman -S fcitx5-pinyin-zhwiki

# 从 AUR 安装云拼音（可选）
yay -S fcitx5-pinyin-moegirl fcitx5-pinyin-sougou

Fedora

# 安装 fcitx5 和中文输入引擎
sudo dnf install fcitx5 fcitx5-chinese-addons fcitx5-qt fcitx5-gtk

# 安装配置工具
sudo dnf install fcitx5-configtool

openSUSE

# 安装 fcitx5 和中文输入引擎
sudo zypper install fcitx5 fcitx5-chinese-addons fcitx5-qt fcitx5-gtk

# 安装配置工具
sudo zypper install fcitx5-configtool

切换 Fcitx5 输入法

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

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

# 3. 设置 Fcitx5 软件开机自启
mkdir -p ~/.config/autostart
cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart/

配置 Fcitx5

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

# 启动 fcitx5 配置界面
fcitx5-configtool

基本配置步骤：

1. 添加输入法：在配置工具左侧点击+ → 取消勾选仅显示当前语言 → 搜索 Pinyin 添加
2. 设置切换快捷键：在「全局选项」中设置触发键（默认 Ctrl+Space）
3. 调整候选词数量：在「附加组件」→ «Pinyin» 中调整候选词显示数量
4. 云拼音：在「附加组件」→ «CloudPinyin」中启用并选择云拼音源

使用 Fcitx5

# 手动启动 fcitx5（如果未设置自启）
fcitx5 -d

# 查看 fcitx5 是否运行
fcitx5-diagnose

# 重新加载配置
fcitx5-remote -r

常用快捷键：

故障排除

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

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

# 2. 运行诊断工具
fcitx5-diagnose

# 3. 查看日志
fcitx5 -d --verbose

# 4. 重启 fcitx5
fcitx5-remote -e   # 退出
fcitx5 -d          # 重新后台启动

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

• Electron 应用（VS Code、Chrome 等）：设置启动参数

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

• GTK 应用：确认已安装 fcitx5-frontend-gtk3
• Qt 应用：确认已安装 fcitx5-frontend-qt5

候选词不显示中文：

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

卸载 Fcitx5

# Debian/Ubuntu
sudo apt remove fcitx5 fcitx5-chinese-addons
sudo apt autoremove

# Arch Linux
sudo pacman -R fcitx5 fcitx5-chinese-addons

# Fedora
sudo dnf remove fcitx5 fcitx5-chinese-addons

参考资料

• Fcitx5 官方 Wiki
• Fcitx5 Arch Wiki