PyQt5自定义应用中Fcitx输入法无法在输入框使用问题求助

我之前也碰到过一模一样的困扰，结合你描述的现象——普通Qt应用（比如Goldendict、Kate）能正常用Fcitx，但自己写的PyQt5程序和Qt 5.10的Retext不行，确实大概率和Qt版本兼容性或者输入法适配配置有关，下面给你几个实用的解决思路：

1. 先确认Qt版本，优先升级到5.12+ #

Qt 5.10及更早版本对Fcitx的支持存在不少坑，尤其是X11环境下的输入法适配问题。你可以先跑一行代码确认当前PyQt5绑定的Qt版本：

from PyQt5.QtCore import QT_VERSION_STR
print(QT_VERSION_STR)

如果版本低于5.12，建议直接升级到Qt 5.12及以上版本（这个版本开始官方针对Fcitx做了大量优化），对应的PyQt5包也同步更新到对应版本。

2. 手动配置输入法环境变量 #

有时候系统的环境变量没正确传递给PyQt5程序，你可以在启动程序前先设置这几个变量：

export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx

嫌每次手动输麻烦的话，也可以在Python代码最开头设置（注意一定要在导入PyQt5模块之前设置，否则不生效）：

import os
os.environ['QT_IM_MODULE'] = 'fcitx'
os.environ['XMODIFIERS'] = '@im=fcitx'
os.environ['GTK_IM_MODULE'] = 'fcitx'

3. 检查是否安装了Fcitx的Qt5前端插件 #

很多Linux发行版默认不会预装Fcitx的Qt5适配插件，你可以通过包管理器安装：

• Debian/Ubuntu系：sudo apt install fcitx-frontend-qt5
• Arch系：sudo pacman -S fcitx-qt5
  安装完成后重启Fcitx和你的PyQt5程序，再测试输入法是否正常。

4. 用完整测试代码验证 #

你提到的极简代码可以补充完整后测试，比如下面这个版本：

import os
# 先设置环境变量
os.environ['QT_IM_MODULE'] = 'fcitx'
os.environ['XMODIFIERS'] = '@im=fcitx'

import PyQt5.QtWidgets as QtWidgets
import sys

class App(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.initUI()
        
    def initUI(self):
        self.setWindowTitle('Fcitx输入测试')
        layout = QtWidgets.QVBoxLayout()
        
        line_edit = QtWidgets.QLineEdit()
        text_edit = QtWidgets.QTextEdit()
        
        layout.addWidget(line_edit)
        layout.addWidget(text_edit)
        
        self.setLayout(layout)
        self.show()

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    ex = App()
    sys.exit(app.exec_())

按照前面的步骤配置后，运行这个代码应该就能正常使用Fcitx输入了。

总结 #

最常见的问题就是Qt版本过低、环境变量未配置到位，或者缺少Fcitx的Qt适配插件，按上面的步骤逐一排查，基本都能解决问题。

内容的提问来源于stack exchange，提问作者Nguyen Duc Toan