Ubuntu 24.04 GNOME Wayland 完整版 Fcitx5 + Rime（雾凇拼音）安装配置手册

前置说明

1. Ubuntu24.04 默认GNOME+Wayland，本方案完美兼容VSCode、WPS、Chrome、JetBrains、Electron类软件，无候选框漂移、输入失效问题

2. 全程无广告、本地词库优先、隐私友好，雾凇拼音大幅提升中文输入准确率

3. 所有命令适配清华源官方包，修正前期包名错误（librime-lua→librime-plugin-lua、noto-fonts-emoji→fonts-noto-color-emoji）

一、更新软件源并安装全套依赖

打开终端逐条执行整合安装命令：

sudo apt update
sudo apt install -y \
fcitx5 \
fcitx5-config-qt \
fcitx5-frontend-gtk3 \
fcitx5-frontend-gtk4 \
fcitx5-frontend-qt5 \
fcitx5-rime \
librime-plugin-lua \
git \
fonts-noto-color-emoji

包功能说明

| 软件包 | 作用 | |--------|------| | fcitx5 | 输入法核心框架 | | fcitx5-config-qt | Fcitx5图形化配置面板 | | fcitx5-frontend-gtk3/gtk4 | 适配GNOME GTK4软件（系统设置、浏览器），解决无法输入中文 | | fcitx5-frontend-qt5 | 适配Qt类软件（WPS、JetBrains IDE） | | fcitx5-rime | Rime中州韵输入法引擎 | | librime-plugin-lua | 雾凇拼音Lua脚本依赖 | | git | 拉取雾凇词库配置 | | fonts-noto-color-emoji | 彩色Emoji字体，避免表情方块乱码 |

二、设置系统默认输入法框架（关键步骤）

1. 命令切换输入框架

im-config -n fcitx5

弹出图形窗口后，全程确认选择 fcitx5，完成系统级输入法切换。

2. 写入全局环境变量（解决Wayland/跨软件输入失效）

编辑用户环境配置文件：

nano ~/.pam_environment

清空原有内容，粘贴以下配置（禁止添加export关键字）：

GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx
XMODIFIERS DEFAULT=@im=fcitx
INPUT_METHOD DEFAULT=fcitx
SDL_IM_MODULE DEFAULT=fcitx

保存退出：Ctrl+O → 回车确认文件名 → Ctrl+X

3. 注销桌面使环境变量生效（必须执行）

gnome-session-quit

注销后重新登录系统，所有环境配置才会加载完成。

三、部署雾凇拼音 rime-ice（增强词库，原生Rime词库极小）

1. 拉取雾凇完整配置文件

# 创建Rime配置目录
mkdir -p ~/.local/share/fcitx5/rime
cd ~/.local/share/fcitx5/rime
# 克隆雾凇仓库
git clone https://github.com/iDvel/rime-ice.git temp --depth 1
# 移动文件到rime主目录并清理临时文件夹
mv temp/* .
rm -rf temp

2. 配置默认输入方案，启用雾凇拼音

nano ~/.local/share/fcitx5/rime/default.custom.yaml

写入完整优化配置：

patch:
  # 指定默认输入方案为雾凇拼音
  schema_list:
    - schema: rime_ice

  # 候选词每页显示数量
  menu/page_size: 9
  # 隐藏候选词多余注释，界面简洁
  comment_format: ""

  # Shift左右键快速临时切换中英文
  ascii_composer:
    switch_key:
      Shift_L: commit_code
      Shift_R: commit_code

保存退出。

3. 部署Rime配置，加载新词库

fcitx5-remote -r

四、Wayland专属优化：内嵌预编辑（解决候选框漂移）

作用

打字拼音直接嵌入输入框内部，无悬浮弹窗，彻底解决Ubuntu24.04 Wayland下候选框乱跑、遮挡文字问题，强烈推荐执行。

# 创建配置文件夹
mkdir -p ~/.config/fcitx5/conf
# 写入内嵌预编辑开关
echo "PreeditInApplication=True" >> ~/.config/fcitx5/conf/rime.conf
# 重启Fcitx5框架生效
fcitx5-remote -c && fcitx5

若后续不喜欢内嵌模式，执行删除命令恢复悬浮弹窗：  rm ~/.config/fcitx5/conf/rime.conf && fcitx5-remote -c && fcitx5

五、图形面板添加Rime中州韵输入法

1. 打开Fcitx5配置工具

fcitx5-configtool

2. 操作步骤

3. 窗口右下角取消勾选「Only Show Current Language（仅显示当前语言）」

4. 在右侧搜索框输入 Rime，找到 中州韵(Rime)

5. 点击中间 > 箭头，将Rime添加至左侧输入法列表

6. 调整左侧排序（首位为默认英文）：

• Keyboard - English (US)

• Rime（中州韵）

7. 全局快捷键说明（可在Global Options标签修改）

• Ctrl + 空格：全局中英文切换

• 左右Shift：临时切换英文，松开自动切回中文

六、可选优化配置

1. Fcitx5开机自启（防止托盘图标消失）

mkdir -p ~/.config/autostart
nano ~/.config/autostart/fcitx5.desktop

写入内容：

[Desktop Entry]
Type=Application
Name=Fcitx5 Input Method
Exec=fcitx5
Comment=Start Fcitx5 Input Framework

2. 彻底卸载系统IBus（避免输入法冲突，可选）

sudo apt purge ibus* -y
sudo apt autoremove -y

3. 美化候选框主题（Material风格）

mkdir -p ~/.local/share/fcitx5/themes
git clone https://github.com/hosxy/Fcitx5-Material-Color.git ~/.local/share/fcitx5/themes/Material-Color

打开fcitx5-configtool → Addons → 经典用户界面，切换对应色系主题。

七、日常使用操作指南

1. 重新部署Rime（修改词库/配置后必执行）

• 图形操作：右上角托盘小企鹅图标右键 → Rime → 重新部署

• 命令操作：fcitx5-remote -r

1. 翻页快捷键：- 上一页、= 下一页

2. 快速英文输入：输入前缀 / 后直接打英文单词

3. 诊断输入法异常（无法输入、崩溃时排查）

fcitx5-diagnose

八、常见故障排查

故障1：VSCode/WPS/浏览器无法输入中文

1. 确认已安装 fcitx5-frontend-gtk4

2. 检查 ~/.pam_environment 配置完整无误

3. 注销账户重新登录，重启对应软件

故障2：配置面板找不到Rime输入法

1. 取消右下角「仅显示当前语言」勾选框

2. 执行重启Fcitx5：fcitx5-remote -c && fcitx5

3. 验证安装：apt list --installed | grep fcitx5-rime

故障3：Emoji显示方块

确认已安装 fonts-noto-color-emoji，执行重新部署Rime：fcitx5-remote -r

故障4：托盘无Fcitx小企鹅图标

1. 手动启动：fcitx5

2. 检查开机自启desktop文件是否创建成功

3. GNOME扩展：安装AppIndicator Support扩展以显示托盘图标