PyQt6 GUI设置保存至INI文件报错：MainWindow无settings属性

错误原因 #

报错AttributeError: 'MainWindow' object has no attribute 'settings'的核心问题：

• self.settings仅在loadSettings方法内被赋值，但程序运行时从未调用过loadSettings，导致MainWindow实例不存在该属性。
• 即使调用loadSettings，每次调用都会重新创建QSettings实例，不符合配置管理的常规逻辑。

修复方案 #

1. 在MainWindow的__init__方法中初始化self.settings，确保实例创建时就具备该属性。
2. 在__init__末尾调用loadSettings加载配置。
3. 优化配置加载逻辑：利用QSettings的value方法默认值参数简化代码，避免不必要的字符串转布尔操作；同时改进异常捕获，保留调试信息。

修改后的main.py代码 #

import sys

from PyQt6.QtCore import QSettings
from PyQt6.QtWidgets import QApplication, QMainWindow

from ui.test import Ui_MainWindow

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)
        self.setWindowTitle("Test Tool")
        # 初始化QSettings实例
        self.settings = QSettings("./TestTool.ini", QSettings.Format.IniFormat)
        # 加载配置
        self.loadSettings()

    def closeEvent(self, event):
        self.saveSetting()
        print("Exit")

    def saveSetting(self):
        print("Save settings")
        self.settings.setValue("Debug", self.ui.checkBox.isChecked())

    def loadSettings(self):
        try:
            print("Load settings...")
            # 直接用value方法的默认值，自动处理类型转换
            self.ui.checkBox.setChecked(self.settings.value("Debug", False, type=bool))
        except Exception as e:
            # 打印错误信息便于调试
            print(f"加载配置失败: {str(e)}")

def main_GUI():
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    return app, window

if __name__ == "__main__":
    app, window = main_GUI()
    rc = app.exec()
    print(f"App end is exit code {rc}")
    sys.exit(rc)

额外说明 #

• QSettings的value方法可以通过type参数直接指定返回类型，无需手动转换字符串，更简洁可靠。
• 初始化时创建QSettings实例，避免重复创建，保证配置读写的一致性。

内容的提问来源于stack exchange，提问作者thomas.tm