PyQt5中QListWidget的currentTextChanged信号初始化默认触发问题

QListWidget 存在默认选中逻辑：向空的QListWidget添加条目后，控件会自动将第一个条目设置为当前选中项，这个初始选中状态的赋值过程，会直接触发currentTextChanged信号。该行为是Qt控件的默认初始化逻辑，和是否手动点击操作、使用什么开发环境无关。

可根据业务场景选择以下任意一种方案实现首次加载不触发信号的需求：

• 方案1：增加初始化标记位，屏蔽初始化阶段的信号处理
  初始化完成前标记位设为False，信号触发时直接跳过逻辑；所有控件配置完成后再将标记位设为True，正常响应后续用户操作触发的信号，参考代码：

import sys
from PyQt5.QtWidgets import QMainWindow, QApplication, QListWidget

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("My App")
        self._init_finished = False
        widget = QListWidget()
        widget.addItems(["One", "Two", "Three"])
        widget.currentTextChanged.connect(self.text_changed)
        self.setCentralWidget(widget)
        self._init_finished = True

    def text_changed(self, s):
        if not self._init_finished:
            return
        print(s)

app = QApplication(sys.argv)
window = MainWindow()
window.show()
app.exec_()

• 方案2：初始化阶段临时阻塞控件信号，配置完成后恢复
  调用控件自带的blockSignals方法，在添加条目、设置初始状态的阶段暂时屏蔽信号发射，所有初始配置完成后再恢复信号，再绑定信号处理函数即可，参考代码：

import sys
from PyQt5.QtWidgets import QMainWindow, QApplication, QListWidget

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("My App")
        widget = QListWidget()
        widget.blockSignals(True)
        widget.addItems(["One", "Two", "Three"])
        # 如果需要初始状态无任何选中项，可取消注释下一行代码
        # widget.setCurrentRow(-1)
        widget.blockSignals(False)
        widget.currentTextChanged.connect(self.text_changed)
        self.setCentralWidget(widget)

    def text_changed(self, s):
        print(s)

app = QApplication(sys.argv)
window = MainWindow()
window.show()
app.exec_()

补充说明：如果业务上不需要默认选中第一个条目，直接调用setCurrentRow(-1)将选中行设为-1，即可让控件初始状态无选中项，从根源避免初始状态触发信号。

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