PyQt5的QComboBox调用clear()方法更新下拉选项异常问题求解

我有一个从CSV文件读取数据的QComboBox控件，下拉选项会展示两个值，格式为a | b，基础实现逻辑运行正常。
我新增了一个按钮功能，用于向CSV文件追加新数据行，之后需要将QComboBox的选项更新为最新的CSV内容，因此我首先清空下拉框中已加载的旧值。
下述代码中问题疑似出在self.comboSiteCodes.clear()这一行：如果移除该行代码，功能可正常运行，但更新后的CSV内容会追加到原有下拉列表末尾，出现选项重复问题；保留该行则功能异常。请问我的代码哪里存在错误？

def add_job(self):
    code, good = QInputDialog.getText(self, '\n', 'Input Site Code')
    if good:
        folder, good = QInputDialog.getText(self, '\n', 'Input Folder Prefix')
        if good:
            with open("data/job_list.csv", "a") as myfile:
                myfile.write("\n" + code + ',' + folder)

    # self.update_site_folder_combo()

    self.comboSiteCodes.clear()

    job_list = pd.read_csv(filepath_or_buffer="data/job_list.csv", header=0)
    tuples = job_list[['SITECODE', 'FOLDER']]
    for row in tuples.itertuples():
        self.comboSiteCodes.addItem('{} | {}'.format(row.FOLDER, row.SITECODE), (row.FOLDER, row.SITECODE))
    self.comboSiteCodes.currentIndexChanged.connect(self.comboSiteCodes_index_changed)

问题原因 #

你的代码存在两个核心错误：

• 重复连接信号槽：currentIndexChanged的信号连接操作不应该放在add_job方法里。你每次点击新增按钮调用该方法时，都会给combo控件多绑定一次槽函数，后续只要触发一次索引变化，就会重复执行多次comboSiteCodes_index_changed逻辑，很容易引发异常。
• clear()方法触发索引变化信号：调用self.comboSiteCodes.clear()清空选项时，控件的当前索引会变为-1，会触发已经绑定的currentIndexChanged信号。如果你的槽函数comboSiteCodes_index_changed没有对索引为-1的边界情况做兼容处理，就会直接出现功能异常。

修复方案 #

1. 将self.comboSiteCodes.currentIndexChanged.connect(self.comboSiteCodes_index_changed)这行代码移到界面初始化的方法中，只在程序启动时绑定一次即可。
2. 清空选项前先临时断开信号连接，加载完新选项后再重新绑定，或者在槽函数开头判断如果当前索引self.comboSiteCodes.currentIndex() < 0就直接返回，跳过执行后续逻辑。
3. 可选优化：写入CSV后最好主动刷新缓冲区、关闭文件句柄后再读取，避免出现读取到的还是旧内容的问题。

修复后的参考代码：

# 界面初始化时执行一次即可，不要放到add_job里
def __init__(self):
    # 其他初始化逻辑...
    self.comboSiteCodes.currentIndexChanged.connect(self.comboSiteCodes_index_changed)

def add_job(self):
    code, good = QInputDialog.getText(self, '\n', 'Input Site Code')
    if good:
        folder, good = QInputDialog.getText(self, '\n', 'Input Folder Prefix')
        if good:
            with open("data/job_list.csv", "a") as myfile:
                myfile.write("\n" + code + ',' + folder)
            # 确保文件写入完成
            myfile.close()

    # 临时断开信号，避免clear触发槽函数
    self.comboSiteCodes.currentIndexChanged.disconnect(self.comboSiteCodes_index_changed)
    self.comboSiteCodes.clear()
    # 重新连接信号
    self.comboSiteCodes.currentIndexChanged.connect(self.comboSiteCodes_index_changed)

    job_list = pd.read_csv(filepath_or_buffer="data/job_list.csv", header=0)
    tuples = job_list[['SITECODE', 'FOLDER']]
    for row in tuples.itertuples():
        self.comboSiteCodes.addItem('{} | {}'.format(row.FOLDER, row.SITECODE), (row.FOLDER, row.SITECODE))

# 槽函数兼容边界情况，双保险
def comboSiteCodes_index_changed(self, index):
    if index < 0:
        return
    # 原有逻辑...

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