fcitx5是搜狗输入法linux版v4.2.1起唯一支持的框架，fcitx4和ibus完全不兼容；必须使用x11协议、启用zh_cn.utf-8 locale、严格匹配发行版与架构，并将环境变量写入~/.pam_environment后注销重登。
fcitx5 是当前搜狗输入法 Linux 版（v4.2.1 起）唯一支持的框架，fcitx4 和 ibus 已完全不兼容。装了也白装，图标能显示但按 Ctrl+Space 没反应、候选框不弹、甚至导致 Chrome 或 WPS 崩溃。
确认系统显示协议必须是 X11，不是 Wayland
搜狗输入法 v4.5.0 仍严重依赖 X11 协议通信，Wayland 下会直接失效：输入框闪烁、sogou-qimpanel 报 Connection refused、快捷键无响应。
- 运行
echo $XDG_SESSION_TYPE，输出必须是x11；若为wayland，需强制切回 Xorg - GNOME 用户：编辑
/etc/gdm3/custom.conf，取消注释并设WaylandEnable=false - KDE 用户：改
/etc/sddm.conf中Session=plasma-x11 - 登录界面右下角有齿轮图标，手动选 “Ubuntu on Xorg” 或 “Plasma (X11)”
安装前必须激活 zh_CN.UTF-8 locale
没启用中文 locale，fcitx5 进程可能启动，但 fcitx5-configtool 里看不到“搜狗”，或添加后无法切换。
linux-performance-analyzer
下载
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
- 执行
locale -a | grep zh_CN.UTF-8，无输出则需生成：sudo locale-gen zh_CN.UTF-8 - Debian/Ubuntu：运行
sudo update-locale LANG=zh_CN.UTF-8 - RHEL/CentOS/Fedora：用
sudo localectl set-locale LANG=zh_CN.UTF-8 - 重启终端或重新登录使环境变量生效
按发行版和架构严格匹配安装包
混用 .deb 和 .rpm、错用架构（如在 arm64 上装 amd64 包）、或用旧版系统包适配新版桌面，都会触发 libfcitx5core.so.5: cannot open shared object file 类错误。
- Ubuntu/Debian：只用官网下载的
sogoupinyin_*.amd64.deb，安装命令为sudo apt install ./sogoupinyin_*.deb（不是dpkg -i） - CentOS/RHEL/Fedora：只用带
el8或el9后缀的sogoupinyin-*.x86_64.rpm，安装前先补依赖：sudo dnf install -y $(rpm -qpR sogoupinyin-*.rpm | grep "missing") - Manjaro/Arch：禁止直接装 .deb/.rpm；走 AUR：
yay -S fcitx5-sogou，避免 Qt 库版本错配（如libfcitx-qt.so.0找不到）
环境变量必须写进 ~/.pam_environment，不能只靠 ~/.xprofile
很多用户把 GTK_IM_MODULE=fcitx5 等写在 ~/.xprofile 或 ~/.bashrc，结果 GNOME/KDE 下部分应用（尤其是 Electron 类如 VS Code、WPS）仍打不出中文——因为这些变量未被 PAM 会话层加载。
- 编辑
~/.pam_environment（不存在则新建），每行一个变量，格式为：GTK_IM_MODULE DEFAULT=fcitx5 - 同理写入：
QT_IM_MODULE DEFAULT=fcitx5和XMODIFIERS DEFAULT=@im=fcitx5 - 注销重登，不要仅重启桌面（
Alt+F2 → r不够） - 验证是否生效：在终端运行
printenv GTK_IM_MODULE，应输出fcitx5
最常被跳过的一步是检查 $XDG_SESSION_TYPE ——哪怕所有包都装对、变量全写齐，只要还在 Wayland 会话里，sogou-qimpanel 就不会真正连接上输入框架。
