在 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 += sql3️⃣ 补充：用 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，适合简单表操作 | 对复杂查询支持不足 |
推荐方案：
简单数据展示 →
QSqlTableModel + QTableView复杂逻辑/多表查询 →
QSqlQuery