Qt中集成并使用SQLite数据库的超完整指南

更新时间：2025年04月21日 11:03:08 作者：威桑

这篇文章主要介绍了Qt中集成并使用SQLite数据库的相关资料,包括环境配置、连接数据库、执行SQL操作、事务处理、使用模型-视图编程、错误处理、高级技巧与注意事项以及常见问题解答,需要的朋友可以参考下

前言

SQLite 是一款轻量级、嵌入式的关系型数据库，无需独立的服务器进程，数据以文件形式存储，非常适合桌面和移动端应用的本地数据管理。Qt 通过 Qt SQL 模块提供了对 SQLite 的原生支持，开发者可以轻松实现数据库的增删改查、事务处理等操作。本文将详细介绍如何在 Qt 中集成并使用 SQLite 数据库。

1. 环境配置与准备工作

1.1 启用 Qt SQL 模块

在 Qt 项目文件（.pro）中添加 SQL 模块依赖：

QT += sql

1.2 包含头文件

在代码中引入必要的类：

#include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>
#include <QSqlTableModel>

2. 连接 SQLite 数据库

2.1 创建并打开数据库

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("my_database.db"); // 数据库文件名（或完整路径）

if (!db.open()) {
    qDebug() << "Error: Failed to open database:" << db.lastError().text();
    return;
}

说明：
- QSQLITE 是 Qt 内置的 SQLite 驱动名称。
- 如果文件不存在，SQLite 会自动创建新数据库。

2.2 关闭数据库

db.close(); // 显式关闭连接（通常不需要，程序退出时自动关闭）

3. 执行 SQL 操作

3.1 创建表

QSqlQuery query;
query.exec("CREATE TABLE IF NOT EXISTS users ("
          "id INTEGER PRIMARY KEY AUTOINCREMENT,"
          "name TEXT NOT NULL,"
          "age INTEGER,"
          "email TEXT UNIQUE)");

3.2 插入数据

直接执行 SQL

query.exec("INSERT INTO users (name, age, email) VALUES ('Alice', 30, 'alice@example.com')");

使用预处理语句（防 SQL 注入）

query.prepare("INSERT INTO users (name, age, email) VALUES (?, ?, ?)");
query.addBindValue("Bob");
query.addBindValue(25);
query.addBindValue("bob@example.com");
query.exec();

3.3 查询数据

if (query.exec("SELECT id, name, age FROM users WHERE age > 20")) {
    while (query.next()) {
        int id = query.value(0).toInt();
        QString name = query.value("name").toString();
        int age = query.value(2).toInt();
        qDebug() << "User:" << id << name << age;
    }
} else {
    qDebug() << "Query error:" << query.lastError().text();
}

3.4 更新与删除数据

// 更新
query.exec("UPDATE users SET age = 31 WHERE name = 'Alice'");

// 删除
query.exec("DELETE FROM users WHERE email IS NULL");

4. 事务处理

通过事务确保多个操作的原子性：

db.transaction(); // 开始事务

QSqlQuery query;
query.exec("UPDATE account SET balance = balance - 100 WHERE id = 1");
query.exec("UPDATE account SET balance = balance + 100 WHERE id = 2");

if (/* 检查操作是否成功 */) {
    db.commit();   // 提交事务
} else {
    db.rollback(); // 回滚事务
}

5. 使用模型-视图（Model-View）编程

Qt 提供了 QSqlTableModel 和 QSqlQueryModel，方便将数据库与 UI 组件（如 QTableView）绑定。

5.1 显示表格数据

QSqlTableModel *model = new QSqlTableModel(this);
model->setTable("users");
model->setFilter("age > 20");
model->select();

QTableView *view = new QTableView;
view->setModel(model);
view->show();

5.2 编辑并保存修改

model->setEditStrategy(QSqlTableModel::OnManualSubmit);
// 用户通过视图修改数据后调用：
model->submitAll(); // 提交所有更改到数据库

6. 错误处理与调试

6.1 捕获数据库错误

if (!query.exec("INVALID SQL")) {
    qDebug() << "SQL Error:" << query.lastError().text();
    qDebug() << "Executed SQL:" << query.lastQuery();
}

6.2 查看支持的数据库驱动

qDebug() << "Available drivers:" << QSqlDatabase::drivers();
// 输出示例：("QSQLITE", "QMYSQL", "QPSQL")

7. 高级技巧与注意事项

7.1 批量插入优化

使用事务加速大批量插入：

db.transaction();
QSqlQuery query;
query.prepare("INSERT INTO users (name) VALUES (?)");
for (const QString &name : namesList) {
    query.addBindValue(name);
    query.exec();
}
db.commit();

7.2 多线程访问

SQLite 默认不支持多线程同时写入，需通过 QSqlDatabase::cloneDatabase 为每个线程创建独立连接。
在子线程中使用数据库时，确保在子线程内打开连接。

7.3 数据库迁移

使用 user_version 字段管理数据库版本：

query.exec("PRAGMA user_version = 1"); // 设置版本号
query.exec("PRAGMA user_version");     // 读取版本号

8. 常见问题解答

Q1：数据库文件被锁定了怎么办？

确保所有 QSqlQuery 和 QSqlDatabase 对象在使用后及时释放。
避免多线程同时写入同一连接。

Q2：如何防止 SQL 注入？

始终使用 prepare() 和 addBindValue() 替代字符串拼接。

Q3：查询性能慢如何优化？

为常用查询字段添加索引。
减少频繁的小事务，合并为批量操作。

9. 完整示例代码

#include <QCoreApplication>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QDebug>

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName("test.db");
    
    if (!db.open()) {
        qDebug() << "Database error:" << db.lastError().text();
        return -1;
    }

    QSqlQuery query;
    query.exec("CREATE TABLE IF NOT EXISTS books ("
               "id INTEGER PRIMARY KEY,"
               "title TEXT,"
               "author TEXT)");

    query.prepare("INSERT INTO books (title, author) VALUES (?, ?)");
    query.addBindValue("Qt Programming");
    query.addBindValue("John Doe");
    query.exec();

    query.exec("SELECT * FROM books");
    while (query.next()) {
        qDebug() << "Book:" << query.value("title").toString()
                 << "by" << query.value("author").toString();
    }

    db.close();
    return a.exec();
}

10. 总结

Qt 的 SQLite 支持使得本地数据管理变得简单高效。核心要点包括：

使用 QSqlDatabase 管理数据库连接。
通过 QSqlQuery 执行 SQL 语句并处理结果。
利用事务保证数据一致性。
结合模型-视图框架快速构建 UI 界面。

官方文档参考：

到此这篇关于Qt中集成并使用SQLite数据库的文章就介绍到这了,更多相关Qt集成使用SQLite数据库内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Qt图形图像开发曲线图表模块QChart库基本用法、各个类之间的关系说明
这篇文章主要介绍了Qt图形图像开发曲线图表模块QChart库基本用法、各个类之间的关系说明,需要的朋友可以参考下
2020-03-03
C++实现学生档案管理系统
这篇文章主要为大家详细介绍了C++实现学生档案管理系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-05-05
C语言深入探究动态规划之线性DP
线性动态规划，是较常见的一类动态规划问题，其是在线性结构上进行状态转移，这类问题不像背包问题、区间DP等有固定的模板，线性动态规划的目标函数为特定变量的线性函数，约束是这些变量的线性不等式或等式，目的是求目标函数的最大值或最小值
2022-04-04
C++实现map和set封装详解
欢迎阅读本指南,将带您深入了解C++中map和set的实现细节,本文将重点介绍如何使用C++标准库中的容器来优化代码,同时提供实用的示例和技巧,无论您是初学者还是资深开发者,本指南都将成为您掌握C++中map和set封装的有力助手,需要的朋友可以参考下
2024-03-03
C语言实现学生奖学金评定系统
这篇文章主要介绍了C语言实现学生奖学金评定系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-03-03
VS报错C1189及MSB3721解决方法
在使用VS进行CUDA编译时出现错误,本文主要介绍了VS报错C1189及MSB3721解决方法,具有一定的参考价值,感兴趣的可以了解一下
2024-06-06
解析c++ 中智能指针引用计数为什么不是0原理
这篇文章主要为大家介绍了C语言中智能指针引用计数为什么不是0原理解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-08-08
详解C++中的ANSI与Unicode和UTF8三种字符编码基本原理与相互转换
在C++编程中，我们有时需要去处理字符串编码的相关问题，常见的字符编码有ANSI窄字节编码、Unicode宽字节编码及UTF8可变长编码。很多人在处理字符串编码问题时都会有疑惑，即便是有多年工作经验的朋友也可能搞不清楚。所以有必要讲一下这三种字符编码以及如何去使用它们
2021-11-11
VSCode插件开发全攻略之跳转到定义、自动补全、悬停提示功能
这篇文章主要介绍了VSCode插件开发全攻略之跳转到定义、自动补全、悬停提示,需要的朋友可以参考下
2020-05-05
C/C++编程判断String字符串是否包含某个字符串实现示例
这篇文章主要为大家介绍了C++编程中判断String字符串是否包含某个字符串的实现示例，有需要的朋友可以借鉴参考下，希望能够有所帮助
2021-11-11