实用指南：Qt的数据库模块介绍，Qt访问SQLite详细示例

news/2025/9/24 17:58:23/文章来源:https://www.cnblogs.com/wzzkaifa/p/19109718

在 Qt 中访问数据库，官方推荐使用 Qt SQL 模块，主要通过 QSqlDatabase、QSqlQuery、QSqlTableModel 等类来操作各种数据库（SQLite、MySQL、PostgreSQL、Oracle 等）。
对于轻量级本地存储，SQLite 是最常用的数据库之一，因为它无需独立服务器、跨平台、零配置。

下面详细介绍 访问方式 和 SQLite Demo。

1️⃣ Qt 访问数据库的方式

方式	特点	适用场景
QSqlDatabase + QSqlQuery	直接操作 SQL 语句，灵活、通用	需要执行复杂 SQL 或自定义查询
QSqlTableModel / QSqlQueryModel	模型/视图模式，直接绑定到 UI（如 QTableView）	数据表直接展示、增删改查
QSqlRelationalTableModel	支持外键关联	多表关系操作

SQLite 属于文件型数据库，Qt 内置驱动名为 QSQLITE，只要系统有 SQLite 库即可直接使用。

2️⃣ SQLite 示例 Demo（QSqlDatabase + QSqlQuery）

下面提供一个完整的 Qt Demo，包括创建数据库、建表、插入数据、查询数据。

文件结构

假设使用 Qt Creator + Widgets 项目

main.cpp
mainwindow.h / mainwindow.cpp （可选）

✅ main.cpp

#include
#include
#include
#include
#include
bool initDatabase()
{
// 1. 连接数据库
QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("test.db");   // 数据库文件名(自动创建)
if (!db.open()) {
qDebug() << "无法打开数据库:" << db.lastError().text();
return false;
}
// 2. 创建表
QSqlQuery query;
QString createSql =
"CREATE TABLE IF NOT EXISTS person ("
"id INTEGER PRIMARY KEY AUTOINCREMENT,"
"name TEXT,"
"age INTEGER)";
if (!query.exec(createSql)) {
qDebug() << "建表失败:" << query.lastError().text();
return false;
}
// 3. 插入数据
query.prepare("INSERT INTO person (name, age) VALUES (:name, :age)");
query.bindValue(":name", "Alice");
query.bindValue(":age", 25);
if (!query.exec()) {
qDebug() << "插入数据失败:" << query.lastError().text();
}
query.bindValue(":name", "Bob");
query.bindValue(":age", 30);
query.exec();
// 4. 查询数据
if (query.exec("SELECT id, name, age FROM person")) {
while (query.next()) {
int id = query.value(0).toInt();
QString name = query.value(1).toString();
int age = query.value(2).toInt();
qDebug() << "id:" << id << " name:" << name << " age:" << age;
}
} else {
qDebug() << "查询失败:" << query.lastError().text();
}
return true;
}
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
if (initDatabase()) {
qDebug() << "数据库初始化完成";
}
return a.exec();
}

⚙️ pro 文件配置

确保在 .pro 文件中加入 Qt SQL 模块：

QT += sql

3️⃣ 补充：用 QSqlTableModel 绑定到 UI

如果需要在 QTableView 中直接显示数据：

#include
#include
QSqlTableModel *model = new QSqlTableModel(this);
model->setTable("person");
model->select();  // 查询所有数据
QTableView *view = new QTableView;
view->setModel(model);
view->show();

这样可以直接进行增删改查，无需手写 SQL。

总结

方式	优点	缺点
QSqlQuery	灵活、可执行任何 SQL 语句	需要自己写 SQL
QSqlTableModel	快速绑定 UI，适合简单表操作	对复杂查询支持不足

推荐方案：