PyQt5中QListWidget鼠标点击选中失效及选中项更新文本框问题

我看了你的代码，已经实现了键盘导航选中QListWidget项的功能，但鼠标点击没生效，而且需要完善选中项更新文本框的逻辑。下面一步步给你解决：

一、核心问题分析 #

1. 鼠标点击无响应：你的代码里只通过eventFilter处理了键盘事件，没有连接QListWidget的鼠标点击相关信号（比如itemClicked或currentItemChanged）。
2. 全局变量滥用：大量使用全局变量会导致状态混乱，比如每次切换焦点新建Sourcefile实例时，全局变量的状态不会重置，容易出问题。
3. 部分函数存在未定义变量：比如func_item_startswith里的startitem_count、item_startswith没有正确传递或定义，会导致报错。

二、修改方案 #

1. 替换全局变量为实例变量 #

把所有全局变量改成Sourcefile的实例变量，避免状态污染：

# 去掉开头的全局变量定义，在__init__里初始化
class Sourcefile(QWidget):
    def __init__(self, textbox, listbox1,listbox2,parent=None):
        super().__init__(listbox2)
        self.setFocusPolicy(Qt.StrongFocus)
        self.tbox1 = textbox
        self.lbox1 = listbox1
        self.lbox2 = listbox2
        self.tbox1.installEventFilter(self)
        self.lbox2.installEventFilter(self)
        # 初始化实例变量替代全局变量
        self.flag = 1
        self.startitem_rowno = 0
        self.enditem_rowno = len(self.lbox2) - 1
        self.search_text_length = 0
        # 连接鼠标点击信号
        self.lbox2.itemClicked.connect(self.on_list_item_clicked)

2. 实现鼠标点击选中并更新文本框的槽函数 #

在Sourcefile类里添加以下方法：

def on_list_item_clicked(self, item):
    # 获取选中项的文本，设置到文本框
    selected_text = item.text()
    self.tbox1.setText(selected_text)
    # 让文本框重新获得焦点
    self.tbox1.setFocus()

这个函数会在用户点击lbox2的任意项时触发，自动把选中的文本填充到对应的输入框，并切换焦点回输入框。

3. 修正func_item_startswith等函数的变量问题 #

原来的func_item_startswith里有未定义的变量，修改成使用实例变量：

def func_item_startswith(self):
    self.flag = 1
    self.startitem_rowno = 0
    # 用实例变量的startitem_count
    self.enditem_rowno = self.startitem_count - 1
    self.lbox2.clear()
    if self.startitem_count > 0:
        for item in self.item_startswith:
            self.lbox2.addItem(item.text())
    else:
        print("No Matching from start item")

同时在func_textbox_textchanged里把所有全局变量替换成实例变量：

def func_textbox_textchanged(self, txt):
    self.search_text = self.tbox1.text()
    self.search_text_length = len(self.search_text)
    self.total_listbox_item = len(self.lbox2)
    self.item_normal = self.lbox1.findItems("*", Qt.MatchWildcard)
    self.item_startswith = self.lbox1.findItems(self.search_text, Qt.MatchStartsWith)
    self.normal_count = len(self.item_normal)
    self.startitem_count = len(self.item_startswith)
    self.func_item_normal()
    if self.search_text_length >= 1:
        pass
    else:
        self.flag = 1
        self.lbox2.clear()
    if self.flag == 1:
        self.func_item_startswith()
    else:
        self.func_item_normal()

4. 优化焦点切换时的信号连接 #

原来的代码在on_focusChanged里每次新建Sourcefile时，会重复连接textChanged信号，导致多次触发。可以先断开旧的连接，再新建：

def on_focusChanged(self, old, new):
    fwidget = QApplication.focusWidget()
    if fwidget is not None:
        if isinstance(new, QLineEdit) and new != self.current_textbox:
            # 断开旧的信号连接（如果存在）
            if hasattr(self, 'getdetails_1'):
                self.current_textbox.textChanged.disconnect(self.getdetails_1.func_textbox_textchanged)
            self.current_textbox = new
            self.lbox1.clear()
            self.lbox1.addItems(textbox_items[new.objectName()])
            self.lbox2.clear()
            self.lbox2.addItems(textbox_items[new.objectName()])
            self.getdetails_1 = Sourcefile(self.current_textbox, self.lbox1, self.lbox2)
            self.current_textbox.textChanged.connect(self.getdetails_1.func_textbox_textchanged)

三、完整修改后的代码 #

example_source_file_001.py #

from PyQt5.QtWidgets import *
from PyQt5.QtGui import *
from PyQt5.QtCore import *

class Sourcefile(QWidget):
    def __init__(self, textbox, listbox1,listbox2,parent=None):
        super().__init__(listbox2)
        self.setFocusPolicy(Qt.StrongFocus)
        self.tbox1 = textbox
        self.lbox1 = listbox1
        self.lbox2 = listbox2
        self.tbox1.installEventFilter(self)
        self.lbox2.installEventFilter(self)
        # 实例变量替代全局变量
        self.flag = 1
        self.startitem_rowno = 0
        self.enditem_rowno = len(self.lbox2) - 1
        self.search_text_length = 0
        # 连接鼠标点击信号
        self.lbox2.itemClicked.connect(self.on_list_item_clicked)

    def eventFilter(self, source, event):
        cursor_position = None
        textbox_value = None
        if event.type() == QEvent.KeyPress and source is self.tbox1:
            if event.modifiers() == Qt.AltModifier and event.key() == Qt.Key_S:
                self.func_item_startswith()
                return True
            if event.key() == Qt.Key_Down:
                self.lbox2.setFocus()
                self.lbox2.setCurrentRow(self.startitem_rowno)
                cursor_position = self.tbox1.cursorPosition()
                textbox_value = self.tbox1.text()
            if event.key() == Qt.Key_Up:
                self.lbox2.setFocus()
                self.lbox2.setCurrentRow(self.enditem_rowno)
                cursor_position = self.tbox1.cursorPosition()
                textbox_value = self.tbox1.text()
            if event.key() == Qt.Key_Return:
                pass
        if event.type() == QEvent.KeyPress and source is self.lbox2:
            if event.key() == Qt.Key_Left or event.key() == Qt.Key_Backspace:
                self.tbox1.setFocus()
                return True
            elif event.key() == Qt.Key_Return :
                selected_item = self.lbox2.currentItem().text()
                if selected_item is not None:
                    self.tbox1.setText(selected_item)
                    self.tbox1.setFocus()
                return True
            elif event.key() == Qt.Key_Up or event.key() == Qt.Key_Down:
                pass
        return super(Sourcefile, self).eventFilter(source, event)

    def on_list_item_clicked(self, item):
        # 鼠标点击选中项时更新文本框
        selected_text = item.text()
        self.tbox1.setText(selected_text)
        self.tbox1.setFocus()

    def func_item_startswith(self):
        self.flag = 1
        self.startitem_rowno = 0
        self.enditem_rowno = self.startitem_count - 1
        self.lbox2.clear()
        if self.startitem_count > 0:
            for item in self.item_startswith:
                self.lbox2.addItem(item.text())
        else:
            print("No Matching from start item")

    def func_item_normal(self):
        self.flag = 0
        self.startitem_rowno = 0
        self.enditem_rowno = self.normal_count - 1
        self.lbox2.clear()
        if self.normal_count > 0:
            for item in self.item_normal:
                self.lbox2.addItem(item.text())

    def func_textbox_textchanged(self, txt):
        self.search_text = self.tbox1.text()
        self.search_text_length = len(self.search_text)
        self.total_listbox_item = len(self.lbox2)
        self.item_normal = self.lbox1.findItems("*", Qt.MatchWildcard)
        self.item_startswith = self.lbox1.findItems(self.search_text, Qt.MatchStartsWith)
        self.normal_count = len(self.item_normal)
        self.startitem_count = len(self.item_startswith)
        self.func_item_normal()
        if self.search_text_length >= 1:
            pass
        else:
            self.flag = 1
            self.lbox2.clear()
        if self.flag == 1:
            self.func_item_startswith()
        else:
            self.func_item_normal()

example_main_001.py（仅修改on_focusChanged部分） #

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from example_source_file_001 import Sourcefile

textbox_items = {
    "textbox1": ["Python", "Python 2.7", "Python 2.9", "Python 3.5", "Python 3.7", "National", "Zebra", "Apple", "X Ray", "Boat", "Tiger", "Item001", "Item002", "Item003", "Item004", "Item005", "001Item", "002Item", "003Item", "004Item", "005Item", "Ball", "Cat", "Dog", "Fish", "Gold Fish", "Star Fish", "2821", "2822", "2823", "2811", "2812", "2813"],
    "textbox2": ["India","America","Russia","China","England","Iran","Iraq","Ice Land"],
    "textbox3": ["Red", "Dark red", "Light Red", "Redish Blue", "Redish Green", "Green","Blue","Dark Blue", "Dark Green"]
}

class Mclick_sample_main(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Mouse click Samples")
        self.textbox1 = QLineEdit()
        self.textbox2 = QLineEdit()
        self.textbox3 = QLineEdit()
        self.lbox1 = QListWidget()
        self.lbox2 = QListWidget()
        self.textbox1.setObjectName("textbox1")
        self.textbox2.setObjectName("textbox2")
        self.textbox3.setObjectName("textbox3")
        self.lbox1.setObjectName("listbox1")
        self.lbox2.setObjectName("listbox2")
        vbox = QVBoxLayout(self)
        vbox.addWidget(self.textbox1)
        vbox.addWidget(self.textbox2)
        vbox.addWidget(self.textbox3)
        vbox.addWidget(self.lbox2)
        self.current_textbox = None
        QApplication.instance().focusChanged.connect(self.on_focusChanged)
        self.textbox1.returnPressed.connect(lambda: self.textbox2.setFocus(Qt.ShortcutFocusReason))
        self.textbox2.returnPressed.connect(lambda: self.textbox3.setFocus(Qt.ShortcutFocusReason))
        self.textbox3.returnPressed.connect(lambda: self.textbox1.setFocus(Qt.ShortcutFocusReason))

    def on_focusChanged(self, old, new):
        fwidget = QApplication.focusWidget()
        if fwidget is not None:
            if isinstance(new, QLineEdit) and new != self.current_textbox:
                # 断开旧的信号连接，避免重复触发
                if hasattr(self, 'getdetails_1'):
                    self.current_textbox.textChanged.disconnect(self.getdetails_1.func_textbox_textchanged)
                self.current_textbox = new
                self.lbox1.clear()
                self.lbox1.addItems(textbox_items[new.objectName()])
                self.lbox2.clear()
                self.lbox2.addItems(textbox_items[new.objectName()])
                self.getdetails_1 = Sourcefile(self.current_textbox, self.lbox1, self.lbox2)
                self.current_textbox.textChanged.connect(self.getdetails_1.func_textbox_textchanged)

def main():
    myapp = QApplication(sys.argv)
    mywin = Mclick_sample_main()
    mywin.show()
    sys.exit(myapp.exec_())

if __name__ == "__main__":
    main()

四、效果说明 #

1. 鼠标点击功能：现在点击lbox2里的任意项，对应的文本框会自动填充选中的内容，并且焦点回到文本框。
2. 键盘功能保留：原来的上下键导航、回车选中、Alt+S等功能依然正常工作。
3. 状态更稳定：替换全局变量为实例变量后，切换不同文本框时，每个Sourcefile实例的状态独立，不会互相干扰。

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