如何在PyQt5的QPlainTextEdit控件中实现输入字符的自动替换

无需做全量文本拼接替换，更合理的方案是自定义QPlainTextEdit子类，重写键盘输入事件实现实时字符映射，该方案不会出现光标错位、性能更高，也能避免全量替换的冗余操作。

具体实现步骤 #

• 第一步：自定义继承QPlainTextEdit的子类，内置字符映射表，重写keyPressEvent方法处理输入逻辑
• 第二步：将原有代码里的输入控件替换为自定义类即可
• 如果需要支持多字符组合映射（比如输入sh对应单个僧伽罗字符），可以增加临时变量缓存最近输入的字符，匹配到组合规则后替换即可

自定义输入控件代码 #

from PyQt5 import QtCore, QtGui, QtWidgets

# 字符映射表，可自行替换为僧伽罗语对应的完整映射规则
CHAR_MAP = {
    'a': 'අ',
    'b': 'බ',
    'c': 'ච',
    # 自行补充所有需要的映射关系
}

class MappedPlainTextEdit(QtWidgets.QPlainTextEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 如需支持组合映射，可增加缓存变量存储最近输入的字符
        self.last_char = ""

    def keyPressEvent(self, event: QtGui.QKeyEvent) -> None:
        # 只处理无修饰键的可打印字符，功能键（回车、删除、方向键等）走默认逻辑
        if event.text().isprintable() and not event.modifiers():
            input_char = event.text()
            # 单字符映射逻辑
            if input_char in CHAR_MAP:
                self.insertPlainText(CHAR_MAP[input_char])
                return
            # 如需支持组合映射，放开下面注释补充对应逻辑即可
            # combined = self.last_char + input_char
            # if combined in COMBINED_MAP:
            #     # 删除上一个输入的字符
            #     self.textCursor().deletePreviousChar()
            #     self.insertPlainText(COMBINED_MAP[combined])
            #     self.last_char = ""
            #     return
            # self.last_char = input_char
        # 不符合映射规则的按键走原生默认逻辑
        super().keyPressEvent(event)

替换原有控件的方法 #

注意：你当前的代码是pyuic工具从ui文件生成的，不要直接修改这份代码，否则下次重新生成ui时改动会被覆盖。推荐单独写主逻辑文件继承这个UI类，在初始化时替换输入控件，示例如下：

# 主逻辑文件，不要写在生成的ui代码里
from your_ui_file import Ui_MainWindow # 导入你生成的UI类
from PyQt5 import QtWidgets
import sys

class MyMainWindow(QtWidgets.QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        # 替换原有code_input控件为自定义的映射控件
        # 先保存原有控件的位置和属性
        geometry = self.code_input.geometry()
        font = self.code_input.font()
        # 删除原有控件
        self.code_input.deleteLater()
        # 新建自定义控件
        self.code_input = MappedPlainTextEdit(self.centralwidget)
        self.code_input.setGeometry(geometry)
        self.code_input.setFont(font)
        self.code_input.setObjectName("code_input")
        # 原有绑定的逻辑不受影响，比如字体大小调整、运行按钮功能都可以正常使用

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    window = MyMainWindow()
    window.show()
    sys.exit(app.exec_())

方案优势 #

• 实时响应输入，不需要全量扫描和替换整个文本内容，性能更高
• 不会出现光标错位、选中内容丢失的问题
• 支持灵活扩展单字符映射、多字符组合映射规则，完全匹配你要实现的效果
• 改动和原有UI逻辑解耦，不会影响你已有的运行、字体调整等功能

内容的提问来源于stack exchange，提问作者mr. txnh