Ubuntu 24.04 中文输入法安装

基于之前搜集的信息，以下是 Ubuntu 24.04 上安装配置 Fcitx5 内置拼音的完整详细步骤。

第一步：安装 Fcitx5 及相关组件

打开终端（Ctrl+Alt+T），执行以下命令安装 Fcitx5 框架、中文拼音引擎、云拼音模块及各前端支持：

bash 复制代码

# 更新软件包列表
sudo apt update

# 安装 Fcitx5 核心及中文支持
sudo apt install -y \
  fcitx5 \
  fcitx5-chinese-addons \
  fcitx5-module-cloudpinyin \
  fcitx5-config-qt \
  fcitx5-frontend-gtk2 \
  fcitx5-frontend-gtk3 \
  fcitx5-frontend-gtk4 \
  fcitx5-frontend-qt5 \
  fcitx5-frontend-qt6

各包作用说明：

fcitx5：输入法框架核心
fcitx5-chinese-addons：中文输入引擎（拼音、双拼、仓颉、注音等）
fcitx5-module-cloudpinyin：云拼音联想，提升候选词准确率
fcitx5-config-qt：图形配置工具
fcitx5-frontend-gtk* / fcitx5-frontend-qt*：为 GTK 和 Qt 应用提供输入法前端支持 $1$

第二步：配置环境变量（关键）

Ubuntu 24.04 默认使用 Wayland 显示服务器，必须正确配置环境变量，否则部分应用无法调用输入法 $1$ $2$ 。

创建环境变量配置文件：

bash 复制代码

mkdir -p ~/.config/environment.d
cat > ~/.config/environment.d/input-method.conf << 'EOF'
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx
EOF

同时写入 ~/.xprofile（兼容 X11 回退场景）：

bash 复制代码

cat > ~/.xprofile << 'EOF'
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
EOF

第三步：设置 Fcitx5 为默认输入法框架

bash 复制代码

# 先删除手动管理的配置文件（否则 im-config 可能拒绝操作）
rm -f ~/.xinputrc

# 设置 Fcitx5 为默认
im-config -n fcitx5

第四步：配置开机自启

bash 复制代码

mkdir -p ~/.config/autostart
cat > ~/.config/autostart/fcitx5.desktop << 'EOF'
[Desktop Entry]
Name=Fcitx5
GenericName=Input Method
Comment=Start Fcitx5 Input Method
Exec=fcitx5
Icon=fcitx
Terminal=false
Type=Application
Categories=System;Utility;
StartupNotify=false
X-GNOME-AutoRestart=false
EOF

第五步：禁用 GNOME 内置 IBus 集成（避免冲突）

GNOME 桌面默认集成 IBus，不清空会导致与 Fcitx5 冲突 $1$ ：

bash 复制代码

gsettings set org.gnome.desktop.input-sources sources "[]"
gsettings set org.gnome.desktop.input-sources mru-sources "[]"

第六步：注销并重新登录

这一步必须执行，环境变量和框架切换需要重新登录会话才能生效 $2$ $3$ ：

bash 复制代码

# 注销当前会话（或直接重启系统）
sudo reboot

第七步：添加拼音输入法

重新登录后，打开 Fcitx5 配置工具：

bash 复制代码

fcitx5-configtool

在配置界面中操作：

进入 "输入法" 选项卡
点击左下角 + 号
取消勾选 "Only Show Current Language"（只显示当前语言）
在搜索框输入 pinyin
选择 Pinyin，点击 "添加"
（可选）同时添加 Cloud Pinyin（云拼音）以获得更好的候选词

第八步：启用云拼音（可选但推荐）

在 Fcitx5 配置工具中：

进入 "附加组件" 选项卡
找到 "Cloud Pinyin"，点击 "配置"
将 "Backend"（后端）设为 Google 或 Baidu（百度词库更符合中文习惯）
启用云拼音 $3$

第九步：验证与测试

bash 复制代码

# 检查 Fcitx5 版本
fcitx5 --version

# 检查进程是否运行
ps aux | grep fcitx5

# 检查输入法激活状态（输出 1 表示已激活）
fcitx5-remote

打开任意文本编辑器（如 Gedit），按 Ctrl+Space 切换输入法，输入拼音测试是否出现候选词。

常用快捷键

快捷键	功能
`Ctrl+Space`	启用/禁用输入法
`Ctrl+Shift`	切换不同输入法
`Shift`	中英文切换

常见问题排查

问题1：某些应用无法输入中文

确认环境变量是否生效：

bash 复制代码

echo $GTK_IM_MODULE
echo $QT_IM_MODULE
echo $XMODIFIERS

正确输出应为 fcitx。若无输出，说明环境变量未加载，检查第二步配置文件后重新登录 $3$ 。

问题2：右上角没有输入法图标

bash 复制代码

killall fcitx5
fcitx5 -d

问题3：候选词窗口不显示

打开配置工具检查主题设置：fcitx5-configtool → "附加组件" → "经典用户界面" → "配置"，确认主题未设为 "无" $3$ 。

问题4：Electron 应用（VSCode、Discord 等）无法输入

编辑应用的 .desktop 文件，在启动命令后添加参数：

bash 复制代码

--enable-features=UseOzonePlatform --ozone-platform=wayland --enable-wayland-ime

或在 VSCode 设置中启用 Wayland IME 支持 $1$ 。

可选增强

安装中文字体和主题美化：

bash 复制代码

# 安装中文字体（防止乱码）
sudo apt install -y fonts-wqy-zenhei fonts-wqy-microhei fonts-noto-cjk

# 安装 Material Color 主题
sudo apt install -y fcitx5-material-color

主题在配置工具中切换："附加组件" → "经典用户界面" → "主题" $3$ 。

Sources: