从零开始：我和 AI 一起在 CachyOS 上装好了中文输入法

一个 Linux 小白的真实经历，全程记录 + 保姆级教程

前两天我装了 CachyOS（一个基于 Arch 的 Linux 发行版），系统很流畅，界面也漂亮。但遇到一个头疼的问题：没法打中文。

网上搜了一堆教程，有的太老，有的太乱。最后我决定直接问 AI。没想到，跟着它的回答一步步做，竟然真的搞定了。

下面就是我们的完整对话记录，我把所有步骤重新整理了一遍，保证简单、清晰、能看懂。

一、我先问了 AI 最基本的问题

我：

CachyOS 安装中文输入法，怎么安装？具体流程是什么？

AI 的回答很直接：
它说 CachyOS 基于 Arch，最推荐用 Fcitx5 框架。但是也要看桌面环境（Desktop Environment，简称 DE）。
然后它甩给我一张表格，让我先搞清楚自己用的是哪个桌面。

桌面环境 推荐输入法框架 特别提醒
KDE Plasma + Wayland Fcitx5 必须额外设置虚拟键盘
KDE Plasma + X11 Fcitx5 正常装就行
GNOME + Wayland IBus GNOME 用 IBus 最省心
Xfce / LXQt / 其他 Fcitx5 通用方案

我一看： 我装的是 KDE Plasma，而且用 echo $XDG_SESSION_TYPE 一查，输出 wayland。所以我要走 Fcitx5 + 虚拟键盘 这条路。

二、跟着 AI 的步骤，开始安装

第 1 步：安装 Fcitx5 和中文组件

打开终端（就是那个黑窗口），复制粘贴下面这行：

1
2
sudo pacman -Syu
sudo pacman -S fcitx5 fcitx5-chinese-addons fcitx5-configtool fcitx5-qt fcitx5-gtk

AI 还特别解释了每个包的作用（我怕记不住，就记了个大概）：

  • fcitx5 —— 主程序

  • fcitx5-chinese-addons —— 拼音、五笔这些输入法引擎

  • fcitx5-configtool —— 图形化设置界面

  • fcitx5-qt 和 fcitx5-gtk —— 让各种软件都能用输入法

我又多装了一个增强词库（AI 建议的）：

1
sudo pacman -S fcitx5-pinyin-zhwiki

第 2 步：配置环境变量（AI 说这步最最关键）

很多人装了不能用，就是忘了这步。
用下面的命令编辑系统环境文件：

1
sudo nano /etc/environment

在文件末尾另起三行，写上：

1
2
3
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx

按 Ctrl+O 保存，Ctrl+X 退出。

AI 的解释：这三行告诉电脑“以后所有程序都给我用 fcitx 作为输入法模块”。

第 3 步：设置开机自动启动

1
sudo cp /usr/share/applications/org.fcitx.Fcitx5.desktop /etc/xdg/autostart/

这样每次登录系统，输入法就会自己跑起来。

第 4 步：注销，重新登录

一定要注销！ 不是关机再开，是点左下角菜单里的“注销”（Log Out）。
重新登录后，修改才能生效。

第 5 步：在图形界面里添加拼音输入法

重新登录后，在开始菜单里找到 “Fcitx5 配置” 并打开。

  • 点 “输入法” 标签

  • 点左下角的 “+” 号

  • 如果没看到 “Pinyin”，就取消勾选右下角的 “仅显示当前语言”

  • 找到 “Pinyin”，选中，点“添加”

  • 关掉窗口

现在按下 Ctrl + 空格，就能切到中文拼音了！

三、我遇到了一个坑：KDE Wayland 下打不开输入法

按照上面做完，我按 Ctrl+空格 没有任何反应。
我赶紧回头翻 AI 的那张表，发现它专门提醒过：

KDE Plasma (Wayland) 用户：必须额外配置虚拟键盘。

于是照做：

  1. 打开 系统设置 → 键盘 → 虚拟键盘

  2. 把下拉框改成 “Fcitx 5 Wayland 启动器”

  3. 点“应用”

然后再次注销、重新登录。
再按 Ctrl+空格 —— 成功了！中文候选词框终于出现了。

四、如果你是 GNOME 用户（AI 给的备选方案）

虽然我没用 GNOME，但 AI 也给了另一套方案。我把它贴出来，方便用 GNOME 的朋友：

安装 IBus 和拼音引擎：

1
sudo pacman -S ibus ibus-libpinyin

然后在 GNOME 的 设置 → 区域与语言 → 输入源 里，点“+”添加 “汉语 (Intelligent Pinyin)”。
之后用 Super + 空格（Win键+空格）切换输入法。

五、我遇到的其他小问题（以及怎么解决的）

Q1：按 Ctrl+空格 没反应，但是虚拟键盘也设置了？

AI 建议我运行诊断命令：

1
fcitx5-diagnose

它自动检查，发现我的 GTK 配置文件缺了一行。于是我手动添加：

1
nano ~/.config/gtk-3.0/settings.ini

在 [Settings] 下面加一行：

1
gtk-im-module=fcitx

保存，重启 Firefox，中文就能打了。

Q2：终端里总是报错“找不到输入法模块”？

AI 说这是因为我没完全关闭终端。修改环境变量后，要重新打开终端，甚至注销才彻底生效。

六、最后的总结（给不想看过程的人）

如果你也在 CachyOS 上装中文输入法，只需要记住三点：

  1. 先看自己是什么桌面环境（KDE / GNOME / Xfce）和显示协议（Wayland / X11）。

  2. KDE 用 Fcitx5，GNOME 用 IBus。

  3. KDE + Wayland 必须多一步：在系统设置里把虚拟键盘改成 “Fcitx 5 Wayland 启动器”。

按照我和 AI 的对话步骤，一个一个命令敲，不出半小时你就能流畅地打中文了。

最后说一句： 以前总觉得 Linux 装输入法很麻烦，没想到只要问对人（机），跟着做就行。希望这篇博客也能帮到你。

如果你也遇到了奇怪的问题，欢迎在评论区留言，我会把 AI 教给我的排错方法再分享出来。

—— 一个刚学会在 CachyOS 上打中文的普通用户