当前位置：网站首页 > IT知识 > 正文

如何用 PyQt6 打造一个功能完善的 SQLite 数据库管理工具

liuian 2025-07-17 20:35 73 浏览

如何使用 PyQt6 和 qt_material 库，打造一个功能完善的 SQLite 数据库管理工具，轻松管理和查询 SQLite 数据库。

一、目标

数据库连接与表管理：支持连接 SQLite 数据库，显示数据库中的表，并允许用户选择表进行操作。
表数据分页显示：支持分页显示表数据，方便用户浏览大量数据。
字段信息展示：点击表数据中的字段，展示字段的详细信息。
SQL 查询与结果展示：允许用户输入 SQL 查询语句，并在界面中展示查询结果。
界面美化：使用 qt_material 库，为工具提供美观的界面。

二、技术选型

PyQt6：用于构建图形用户界面（GUI）。PyQt6 是一个功能强大的库，支持快速开发跨平台的桌面应用程序。
qt_material：用于美化界面。qt_material 提供了丰富的主题和样式，让界面更加美观。
SQLite3：作为数据库引擎，用于连接和操作 SQLite 数据库。

三、功能实现与代码优化

以下是实现上述功能的代码实现和优化过程。

1. 初始化界面

初始化主界面，包括数据库选择按钮、表选择下拉框、表数据展示区域、字段信息展示区域和 SQL 查询区域。

def init_ui(self):
    """
    初始化界面布局和组件
    """
    # 主布局
    main_layout = QVBoxLayout()
    main_widget = QWidget()
    main_widget.setLayout(main_layout)
    self.setCentralWidget(main_widget)

    # 操作栏
    self.toolbar = QHBoxLayout()
    main_layout.addLayout(self.toolbar)

    # 数据库选择按钮
    self.open_db_button = QPushButton("选择数据库")
    self.open_db_button.clicked.connect(self.open_database)  # 绑定选择数据库的槽函数
    self.toolbar.addWidget(self.open_db_button)

    # 当前数据库和表信息
    self.db_info_label = QLabel("未选择数据库")
    self.toolbar.addWidget(self.db_info_label)

    # 下部分：左右布局
    self.lower_layout = QHBoxLayout()
    main_layout.addLayout(self.lower_layout)

    # 左侧：表选择和表信息
    self.left_layout = QVBoxLayout()
    self.left_widget = QWidget()
    self.left_widget.setLayout(self.left_layout)
    self.lower_layout.addWidget(self.left_widget)

    # 表选择下拉框
    self.table_combo = QComboBox()
    self.table_combo.currentTextChanged.connect(self.load_table_info)  # 绑定加载表信息的槽函数
    self.left_layout.addWidget(self.table_combo)
    # 设置 QComboBox 的样式
    self.table_combo.setStyleSheet("""
        QComboBox {
            color: white; /* 设置默认文本颜色为白色 */
            background-color: black; /* 设置背景颜色为黑色 */
        }
        QComboBox::item:selected {
            background-color: white; /* 设置选中项的背景颜色为白色 */
            color: black; /* 设置选中项的文本颜色为黑色 */
        }
        QComboBox::item {
            background-color: black; /* 设置下拉菜单项的背景颜色为黑色 */
            color: white; /* 设置下拉菜单项的文本颜色为白色 */
        }
    """)

    # 左侧：表数据展示（分页）
    self.table_data_table = QTableWidget()
    self.table_data_table.setEditTriggers(QAbstractItemView.EditTrigger.NoEditTriggers)  # 设置表格为只读
    self.table_data_table.itemClicked.connect(self.show_field_info)  # 绑定点击表格项的槽函数
    self.table_data_table.horizontalHeader().setSectionResizeMode(QHeaderView.ResizeMode.Interactive)  # 列宽可手动调整
    self.left_layout.addWidget(self.table_data_table)

    # 分页布局
    self.pagination_layout = QHBoxLayout()
    self.pagination_layout.setAlignment(Qt.AlignmentFlag.AlignCenter)  # 居中对齐
    self.left_layout.addLayout(self.pagination_layout)

    self.prev_button = QPushButton("上一页")
    self.prev_button.clicked.connect(self.prev_page)  # 绑定上一页的槽函数
    self.pagination_layout.addWidget(self.prev_button)

    self.page_label = QLabel("1/1")
    self.pagination_layout.addWidget(self.page_label)

    self.next_button = QPushButton("下一页")
    self.next_button.clicked.connect(self.next_page)  # 绑定下一页的槽函数
    self.pagination_layout.addWidget(self.next_button)

    # 右侧：字段信息和 SQL 执行
    self.right_layout = QVBoxLayout()
    self.right_widget = QWidget()
    self.right_widget.setLayout(self.right_layout)
    self.lower_layout.addWidget(self.right_widget)

    # 右侧上部分：字段信息展示区域
    self.field_info_area = QTextEdit()
    self.field_info_area.setReadOnly(True)  # 设置为只读
    self.field_info_area.setPlaceholderText("点击字段以显示详细信息")
    self.right_layout.addWidget(self.field_info_area)

    # 右侧下部分：SQL 执行
    self.sql_layout = QVBoxLayout()
    self.sql_widget = QWidget()
    self.sql_widget.setLayout(self.sql_layout)
    self.right_layout.addWidget(self.sql_widget)

    self.sql_text = QTextEdit()
    self.sql_layout.addWidget(self.sql_text)

    self.execute_button = QPushButton("执行 SQL")
    self.execute_button.clicked.connect(self.execute_sql)  # 绑定执行 SQL 的槽函数
    self.sql_layout.addWidget(self.execute_button)

    # 设置右侧区域的高度比例（字段信息：SQL 区域 = 4:1）
    self.right_layout.setStretchFactor(self.field_info_area, 4)
    self.right_layout.setStretchFactor(self.sql_widget, 1)

2. 数据库连接与表管理

用户可以通过点击“选择数据库”按钮，选择一个 SQLite 数据库文件。程序会连接到数据库，并加载数据库中的表名到下拉框中。

def open_database(self):
    """
    打开 SQLite 数据库文件
    """
    db_path, _ = QFileDialog.getOpenFileName(self, "选择 SQLite 数据库", "", "SQLite Database (*.db *.sqlite)")
    if db_path:
        self.connection = sqlite3.connect(db_path)
        self.cursor = self.connection.cursor()
        self.cursor.execute("SELECT name FROM sqlite_master WHERE type='table';")
        tables = [table[0] for table in self.cursor.fetchall()]

        self.table_combo.clear()
        self.table_combo.addItems(tables)
        self.db_info_label.setText(f"数据库：{db_path}")
        self.current_table = None

3. 表数据分页显示

用户可以选择一个表，程序会分页显示表中的数据。可以通过“上一页”和“下一页”按钮浏览不同页的数据。

def load_table_page(self):
    """
    加载表数据的当前分页内容
    """
    if not self.current_table:
        return

    try:
        self.cursor.execute(f"SELECT * FROM {self.current_table}")
        all_rows = self.cursor.fetchall()
        self.total_pages = (len(all_rows) + self.page_size - 1) // self.page_size

        start_index = (self.current_page - 1) * self.page_size
        end_index = start_index + self.page_size
        rows = all_rows[start_index:end_index]

        self.cursor.execute(f"PRAGMA table_info({self.current_table})")
        columns = [col[1] for col in self.cursor.fetchall()]

        self.table_data_table.setRowCount(len(rows))
        self.table_data_table.setColumnCount(len(columns))
        self.table_data_table.setHorizontalHeaderLabels(columns)

        for i, row in enumerate(rows):
            for j, value in enumerate(row):
                self.table_data_table.setItem(i, j, QTableWidgetItem(str(value)))

        self.page_label.setText(f"{self.current_page}/{self.total_pages}")
    except Exception as e:
        QMessageBox.warning(self, "错误", f"加载表数据失败：{e}")

4. 字段信息展示

可以点击表数据中的字段，程序会在右侧的字段信息区域展示字段的详细信息。

def show_field_info(self, item):
    """
    显示字段信息
    """
    field_value = item.text()
    field_name = self.table_data_table.horizontalHeaderItem(item.column()).text()
    self.field_info_area.setText(f"字段名：{field_name}\n字段值：{field_value}")

5. SQL 查询与结果展示

在右侧的 SQL 输入框中输入 SQL 查询语句，点击“执行 SQL”按钮后，程序会在左侧的表格中展示查询结果。

def execute_sql(self):
    """
    执行 SQL 查询
    """
    sql = self.sql_text.toPlainText()
    try:
        self.cursor.execute(sql)
        self.connection.commit()

        # 获取查询结果
        rows = self.cursor.fetchall()
        columns = [desc[0] for desc in self.cursor.description] if self.cursor.description else []

        # 更新左侧表格以显示查询结果
        self.update_table_data(rows, columns)
        QMessageBox.information(self, "成功", "SQL 执行成功")
    except Exception as e:
        QMessageBox.warning(self, "失败", f"SQL 执行失败：{e}")

def update_table_data(self, rows, columns):
    """
    更新左侧表格以显示查询结果
    """
    self.table_data_table.setRowCount(len(rows))
    self.table_data_table.setColumnCount(len(columns))
    self.table_data_table.setHorizontalHeaderLabels(columns)

    for i, row in enumerate(rows):
        for j, value in enumerate(row):
            self.table_data_table.setItem(i, j, QTableWidgetItem(str(value)))

四、界面美化

qt_material 提供了丰富的主题和样式。

if __name__ == "__main__":
    app = QApplication(sys.argv)
    apply_stylesheet(app, theme="dark_teal.xml")  # 使用 dark_teal 主题
    window = SQLiteManager()
    window.show()
    sys.exit(app.exec())

pyqt combobox