PyQt5 QLineEdit为何丢失ASCII特殊字符？与input()差异及解决方法

现象描述 #

• 使用Python内置input()函数可正常读取USB读卡器输出的含ASCII特殊字符（如\x1d，ASCII码29的分组分隔符）的字符串：

string=input("read: ")
read: 0100630414610870103BD0291724060124011537241422840
string
'0100630414610870103BD029\x1d1724060124011537241\x1d422840'
'\x1d' in string
True

• 但用PyQt5的QLineEdit时，特殊字符会丢失，测试代码如下：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QVBoxLayout
class MiVentana(QWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()
    def init_ui(self):
        self.line_edit = QLineEdit(self)
        self.etiqueta = QLabel('Texto ingresado:', self)
        layout = QVBoxLayout()
        layout.addWidget(self.line_edit)
        layout.addWidget(self.etiqueta)
        self.setLayout(layout)
        self.line_edit.returnPressed.connect(self.actualizar_etiqueta)
        self.setWindowTitle('Ejemplo de QLineEdit')
        self.setGeometry(300, 300, 300, 150)

    def actualizar_etiqueta(self):
        texto_ingresado = self.line_edit.text()
        self.etiqueta.setText('Texto ingresado: ' + texto_ingresado)
        if '\x1d' not in texto_ingresado:
            print("missing chars")
        print(texto_ingresado)
        

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ventana = MiVentana()
    ventana.show()
    sys.exit(app.exec_())

运行输出：

missing chars
0100630414610870103BD0291724060124011537241422840

测试环境：Python 3.11、PyQt5 5.15，多台电脑结果一致。

原因分析 #

QLineEdit默认会过滤不可打印的ASCII控制字符，这类字符不属于常规可见文本输入范畴，因此被组件的默认输入规则拦截丢弃。

解决方法 #

要捕获所有字符，可通过修改输入规则或监听底层事件实现，以下是三种可行方案：

方案1：自定义QLineEdit重写按键事件 #

绕过QLineEdit的默认过滤逻辑，直接捕获原始按键字符并追加到文本：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QVBoxLayout

class CustomLineEdit(QLineEdit):
    def keyPressEvent(self, event):
        char = event.text()
        if char:
            self.setText(self.text() + char)
        else:
            super().keyPressEvent(event)

class MiVentana(QWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()
    def init_ui(self):
        self.line_edit = CustomLineEdit(self)
        self.etiqueta = QLabel('Texto ingresado:', self)
        layout = QVBoxLayout()
        layout.addWidget(self.line_edit)
        layout.addWidget(self.etiqueta)
        self.setLayout(layout)
        self.line_edit.returnPressed.connect(self.actualizar_etiqueta)
        self.setWindowTitle('Ejemplo de QLineEdit')
        self.setGeometry(300, 300, 300, 150)

    def actualizar_etiqueta(self):
        texto_ingresado = self.line_edit.text()
        self.etiqueta.setText('Texto ingresado: ' + texto_ingresado)
        if '\x1d' in texto_ingresado:
            print("特殊字符已捕获")
        print(repr(texto_ingresado))
        

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ventana = MiVentana()
    ventana.show()
    sys.exit(app.exec_())

方案2：用QTextEdit替代QLineEdit #

QTextEdit默认支持接收更多字符类型，包括不可打印控制字符，直接替换组件即可：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QTextEdit, QVBoxLayout

class MiVentana(QWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()
    def init_ui(self):
        self.text_edit = QTextEdit(self)
        self.etiqueta = QLabel('Texto ingresado:', self)
        layout = QVBoxLayout()
        layout.addWidget(self.text_edit)
        layout.addWidget(self.etiqueta)
        self.setLayout(layout)
        self.text_edit.returnPressed.connect(self.actualizar_etiqueta)
        self.setWindowTitle('Ejemplo de QTextEdit')
        self.setGeometry(300, 300, 300, 150)

    def actualizar_etiqueta(self):
        texto_ingresado = self.text_edit.toPlainText()
        self.etiqueta.setText('Texto ingresado: ' + texto_ingresado)
        if '\x1d' in texto_ingresado:
            print("特殊字符已捕获")
        print(repr(texto_ingresado))
        

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ventana = MiVentana()
    ventana.show()
    sys.exit(app.exec_())

方案3：监听应用层原始输入事件 #

通过重写QApplication的notify方法，全局拦截输入事件确保字符不丢失：

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QLineEdit, QVBoxLayout
from PyQt5.QtCore import QEvent

class CustomApp(QApplication):
    def notify(self, receiver, event):
        if event.type() == QEvent.KeyPress:
            char = event.text()
            if char and isinstance(receiver, QLineEdit):
                receiver.setText(receiver.text() + char)
                return True
        return super().notify(receiver, event)

class MiVentana(QWidget):
    def __init__(self):
        super().__init__()
        self.init_ui()
    def init_ui(self):
        self.line_edit = QLineEdit(self)
        self.etiqueta = QLabel('Texto ingresado:', self)
        layout = QVBoxLayout()
        layout.addWidget(self.line_edit)
        layout.addWidget(self.etiqueta)
        self.setLayout(layout)
        self.line_edit.returnPressed.connect(self.actualizar_etiqueta)
        self.setWindowTitle('Ejemplo de QLineEdit')
        self.setGeometry(300, 300, 300, 150)

    def actualizar_etiqueta(self):
        texto_ingresado = self.line_edit.text()
        self.etiqueta.setText('Texto ingresado: ' + texto_ingresado)
        if '\x1d' in texto_ingresado:
            print("特殊字符已捕获")
        print(repr(texto_ingresado))
        

if __name__ == '__main__':
    app = CustomApp(sys.argv)
    ventana = MiVentana()
    ventana.show()
    sys.exit(app.exec_())

注意：以上方案针对HID模拟键盘类型的读卡器有效，若读卡器为其他通信类型（如串口），需对应调整读取方式。

内容的提问来源于stack exchange，提问作者user23323110