fcitx5是搜狗输入法linux版（v4.2.1起）的唯一依赖框架，不再兼容fcitx4或ibus；必须匹配系统发行版、架构及显示协议（x11），并正确配置环境变量与locale。
fcitx5 是必须的，不是可选的
搜狗输入法 Linux 版（v4.2.1 及之后）已完全基于 fcitx5 框架重构，不再兼容旧版 fcitx4 或 ibus。强行用 fcitx4 配置只会看到“搜狗”图标但无法激活输入框，甚至导致应用崩溃。
- Ubuntu/Debian 系统：运行
sudo apt install fcitx5 fcitx5-pinyin fcitx5-configtool libqt5widgets5 libqt5gui5 libqt5dbus5 - CentOS/RHEL/Fedora：运行
sudo dnf install fcitx5 fcitx5-pinyin fcitx5-configtool qt5-qtbase-gui qt5-qtbase-dbus - 确认 locale 已启用中文：执行
locale -a | grep zh_CN.UTF-8，无输出则先运行sudo locale-gen zh_CN.UTF-8和sudo update-locale LANG=zh_CN.UTF-8
安装包必须匹配发行版和架构，不能混用
官网下载页面（https://pinyin.sogou.com/linux/）提供 .deb 和 .rpm 两类包，但实际还隐含架构约束——当前仅支持 x86_64、arm64、loongarch64 和 mips64el。在 Ubuntu 24.04 或 Kali Rolling 上误用为 CentOS 8 编译的 .rpm，会导致 libfcitx5core.so.5: cannot open shared object file 类错误。
- Debian/Ubuntu 用户：只用
sogoupinyin_xxx_amd64.deb，安装命令为sudo apt install ./sogoupinyin_*.deb（不是dpkg -i），它能自动处理依赖冲突 - RHEL/Fedora 用户：只用
sogoupinyin-xxx.el8.x86_64.rpm或对应版本后缀的包，安装前先运行sudo dnf install -y $(rpm -qpR sogoupinyin-*.rpm | grep "missing") - Manjaro/Arch 用户：不要直接装 .deb/.rpm；应通过 AUR 安装
sogoupinyin-fcitx5，避免 Qt 库版本错配（如libfcitx-qt.so.0找不到）
Wayland 下搜狗输入法会失效，必须切回 Xorg
Ubuntu 22.04+、Fedora 38+、Kali Rolling 默认启用 Wayland 显示服务器，而搜狗输入法 v4.5.0 仍严重依赖 X11 协议通信。现象包括：输入框闪烁、切换快捷键（Ctrl+Space）无响应、sogou-qimpanel 启动报 Connection refused。
- GNOME 用户：编辑
/etc/gdm3/custom.conf，取消注释并设为WaylandEnable=false；若用 SDDM（KDE），则改/etc/sddm.conf中Session=plasma-x11 - 登录界面右下角通常有齿轮图标，点击可手动选择 “Ubuntu on Xorg” 或 “Plasma (X11)”
- 验证是否生效：登录后运行
echo $XDG_SESSION_TYPE，输出必须是x11，不是wayland
环境变量不生效常因 shell 配置位置错误
即使 fcitx5 进程在运行，fcitx5-configtool 里也启用了 Sogou Pinyin，输入法仍不出现——大概率是桌面环境没读到关键变量。GNOME/KDE 不同于终端，它们不 source ~/.bashrc 或 ~/.zshrc。
- 全局生效：把以下两行加入
/etc/environment（注意无 export，无引号）：GTK_IM_MODULE=fcitx5QT_IM_MODULE=fcitx5 - GNOME 特别要求：还需运行
gsettings set org.gnome.settings-daemon.plugins.keyboard input-sources "[('fcitx5', 'sogoupinyin')]" - 检查是否加载：启动任意 GTK/Qt 应用后，在终端运行
ps aux | grep fcitx5，应看到fcitx5和sogou-qimpanel两个进程
dpkg -i 强装 deb 包却没补全 Qt5 插件依赖。这些点不手动验证，光重启十次也没用。
