PySide2中QListWidget弹出式代码补全的焦点与隐藏问题排查

焦点问题的根源与修复 #

1. 核心问题：Qt.Popup窗口默认会自动获取焦点，且你将setFocusPolicy(Qt.NoFocus)放在了show()之后，导致设置未生效；仅靠焦点策略无法完全阻止弹窗抢焦点，需强制将焦点切回编辑器。
2. 修复代码：
   • 初始化时就设置弹窗的焦点策略，避免重复操作；
   • 显示弹窗后立即将焦点还给QPlainTextEdit。

# 初始化部分调整
self.temp_completer_list = ["for", "while", "if", "else", "elif", "def",
                           "class", "import", "from", "return", "try", 
                           "except", "finally"]
self.completer_list = QListWidget()
self.completer_list.addItems(self.temp_completer_list)
self.completer_list.setWindowFlag(Qt.Popup)
self.completer_list.setFocusPolicy(Qt.NoFocus)  # 初始化时设置
self.completer_list.hide()
self.textChanged.connect(self.show_completer_list)

# 显示弹窗的方法调整
def show_completer_list(self):
    cursor = self.textCursor()
    pos = self.cursorRect(cursor).bottomRight()
    global_pos = self.mapToGlobal(pos)
    self.completer_list.move(global_pos)
    self.completer_list.show()
    self.setFocus()  # 强制将焦点切回编辑器

弹窗隐藏不稳定的修复 #

需要监听多个触发隐藏的场景，通过事件过滤器统一处理：

完整代码补充 #

def __init__(self, parent=None):
    super().__init__(parent)
    # （保留之前的初始化代码）
    # 安装事件过滤器
    self.installEventFilter(self)
    self.completer_list.installEventFilter(self)

def eventFilter(self, obj, event):
    # 处理编辑器的触发场景
    if obj == self:
        # 按下Esc键隐藏弹窗
        if event.type() == QEvent.KeyPress and event.key() == Qt.Key_Escape:
            self.completer_list.hide()
            return True
        # 编辑器失去焦点时隐藏弹窗
        elif event.type() == QEvent.FocusOut:
            self.completer_list.hide()
        # 光标移动时隐藏弹窗（可根据需求调整触发逻辑）
        elif event.type() == QEvent.CursorChange:
            self.completer_list.hide()
    # 处理弹窗的外部点击场景
    elif obj == self.completer_list:
        if event.type() == QEvent.WindowDeactivate:
            self.completer_list.hide()
    return super().eventFilter(obj, event)

关键逻辑说明 #

• Esc按键：直接监听按键事件，按下后立即隐藏弹窗；
• 焦点离开编辑器：用户点击其他控件时，弹窗自动隐藏；
• 光标移动：光标位置变化时隐藏弹窗，确保补全仅在当前输入位置生效；
• 弹窗失活：用户点击弹窗外部区域时，通过WindowDeactivate事件触发隐藏。

额外优化建议 #

• 不要每次textChanged都显示弹窗，应判断当前输入的是单词前缀时再弹出，避免无效弹窗；
• 添加补全项点击插入功能：

self.completer_list.itemClicked.connect(self.insert_completion)

def insert_completion(self, item):
    text = item.text()
    cursor = self.textCursor()
    # 删除当前输入的前缀（需根据实际需求调整长度逻辑）
    cursor.movePosition(QTextCursor.Left, QTextCursor.KeepAnchor, len(self.get_current_word()))
    cursor.insertText(text)
    self.setTextCursor(cursor)
    self.completer_list.hide()

def get_current_word(self):
    # 获取光标所在的当前单词
    cursor = self.textCursor()
    cursor.select(QTextCursor.WordUnderCursor)
    return cursor.selectedText()

内容的提问来源于stack exchange，提问作者Fatih Ünal