输入法框架安装是做什么的
信创桌面的输入法由框架加引擎两部分组成：框架（fcitx 或 fcitx5，随发行版版本不同）负责与窗口系统、应用程序交互，引擎负责具体的拼音、五笔等输入方案。装完框架与中文引擎后，还要通过环境变量告诉 GTK、Qt 程序使用哪个框架，否则会出现候选框不弹出、部分程序打不出中文等问题。环境变量在图形会话启动时读取，配置后需要注销重新登录才生效。
基本信息
| 常见框架 | fcitx 或 fcitx5，以系统实际版本为准 |
|---|---|
| 中文引擎 | fcitx5-chinese-addons 等中文输入方案包 |
| 配置工具 | fcitx5-configtool 等图形界面工具 |
| 关键环境变量 | GTK_IM_MODULE、QT_IM_MODULE、XMODIFIERS |
| 生效方式 | 写入 ~/.xprofile 或会话启动脚本后注销重登 |
典型使用场景
- 新装信创桌面后默认只有英文输入，需要安装框架与中文引擎
- 迁移用户环境：把输入习惯与自定义词库一并迁移到新终端
- 排查「某个程序里打不出中文」：区分是系统输入法问题还是该程序的输入支持问题
- Wayland 会话下候选框位置异常或不显示，需要按会话类型调整配置
- 终端与远程桌面环境下输入法不工作，检查环境变量是否随会话注入
- 统一交付镜像：把输入法配置固化进模板，减少逐台手工设置
安装与环境变量配置
安装与环境变量配置
sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-configtool # deb 系示例
cat >> ~/.xprofile <<'EOF'
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
EOF
fcitx5 -d --replace # 启动或替换正在运行的实例
fcitx5-diagnose 2>/dev/null | head -30 # 输出诊断信息，排查配置问题
echo $XDG_SESSION_TYPE # 确认是 x11 还是 wayland
fcitx5-configtool # 图形界面添加与调整输入法问题对照
| 现象 | 常见原因 | 处理方向 |
|---|---|---|
| 全局都打不出中文 | 框架未启动或环境变量未生效 | 确认进程存在并注销重登 |
| 只有个别程序异常 | 该程序输入模块支持问题 | 查该程序的输入法配置而非系统 |
| 候选框位置错乱 | 会话类型或框架版本差异 | 确认 X11 与 Wayland 下的配置 |
| 切换键无效 | 快捷键冲突 | 在配置工具中修改切换热键 |
| 重装后仍异常 | 配置未清理或环境变量冗余 | 检查旧配置与环境变量是否重复 |
Wayland 会话下的输入法集成方式与 X11 不同，环境变量与框架参数也可能不一样；遇到候选框不弹出时，先用 echo $XDG_SESSION_TYPE 确认会话类型再对症处理。
只有个别应用打不出中文时，先怀疑该应用的输入模块支持问题，不要反复重装系统输入法；这类问题在重装后依旧存在，浪费大量时间。