在 PyQt 或 PySide 中，`QSql` 模块提供了一套方便的 API 来处理数据库操作。PySide6 的 `QtSql` 模块支持多种常见的数据库引擎（如 SQLite、MySQL 和 PostgreSQL），并且允许我们通过内置功能轻松管理数据表和查询。 以下是关于如何使用 `QSqlDatabase` 及其相关组件的一个详细介绍及示例： ### 一、基本步骤 1. **导入模块** 首先需要从 PySide6.QtSql 导入必要的类和函数。 2. **创建数据库连接** 使用 `QSqlDatabase.addDatabase()` 创建一个新的数据库连接，并指定驱动程序类型 (例如 "QSQLITE" 表示SQLite)。 3. **设置数据库路径或其他配置信息** 4. **打开数据库连接** 5. **执行 SQL 查询或更新命令** 6. **关闭数据库连接** --- ### 示例代码：简单的 SQLite 数据库读写 ```python from PySide6.QtSql import QSqlDatabase, QSqlQuery # 第一步：添加并建立数据库连接 def create_connection(): db = QSqlDatabase.addDatabase("QSQLITE") # 添加一个 SQLite 类型的数据源 db.setDatabaseName("example.db") # 设置数据库文件名 if not db.open(): # 尝试打开数据库 print("无法打开数据库") return False # 如果失败，则返回错误状态 else: print("成功打开了数据库") return True # 成功则继续 if __name__ == "__main__": if not create_connection(): # 调用上面定义好的函数检查是否能够正常连接到数据库 exit(1) query = QSqlQuery() # 初始化 Query 对象用于后续操作 sql_create_table_command=""" CREATE TABLE IF NOT EXISTS persons( id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR(50), age INT);""" success=query.exec_(sql_create_table_command) # 执行建表语句 if(success): print('表格已创建') insert_cmd="INSERT INTO persons(name,age) VALUES ('Alice', 30)" result_insert=query.exec(insert_cmd) select_all_query="SELECT * FROM persons;" query.exec(select_all_query) while(query.next()): # 循环遍历结果集里的每一行记录 person_id=str(query.value(0)) person_name=str(query.value(1)) person_age=str(query.value(2)) print(f"id={person_id}, Name:{person_name}, Age:{person_age}") ``` 上述脚本首先尝试连接本地名为 example.db 的 SQLite 文件。然后它会构建一张叫做 'persons' 的新表（如果不存在的话）。接着插入一条测试数据，并将所有现有条目打印出来。 ### 注意事项： - 确保已经安装了正确的数据库驱动程序以及相应的 Python 绑定。 - 根据实际使用的 RDBMS 修改对应的驱动名称 ("QSQLITE", "QMYSQL", etc.) 和其他初始化参数。 - 错误处理非常重要，在真实项目中建议增加更详细的异常捕获机制。