Qt读写SQLite示例

在 Qt 中读写数据库，常用的方式是通过 Qt SQL 模块（QtSql） ，它提供了一个统一的数据库访问接口，支持多种数据库驱动（SQLite、MySQL、PostgreSQL、ODBC 等）。

对于轻量级的嵌入式应用，SQLite 是最常用的数据库，因为它无需安装独立服务，只需要一个数据库文件即可完成数据存储和读写，非常适合 Qt 桌面应用。

✅ Qt 访问数据库的常用方式

方式	优点	缺点	适用场景
QSqlDatabase + QSqlQuery	直接操作 SQL 语句，灵活、通用	需要手动写 SQL，容易出错	对 SQL 熟悉，灵活需求
QSqlTableModel / QSqlRelationalTableModel	直接与 Qt Model/View 框架配合，支持表格视图显示	只适合简单表格，不便于复杂查询	需要与 QTableView 绑定的 UI
QSqlQueryModel	支持只读 SQL 查询结果显示	不能直接修改数据	需要展示查询结果但不修改数据

👉 推荐：

如果你只是简单地读写数据库，用 QSqlDatabase + QSqlQuery 方式最灵活。
如果要直接绑定到 QTableView，可以用 QSqlTableModel。

💡 示例：Qt 读写 SQLite 数据库

以下示例演示如何使用 QSqlDatabase + QSqlQuery 完成创建数据库、建表、插入数据、查询数据的完整流程。

1️⃣ 工程配置

在 .pro 文件中加入：

复制代码

QT += sql

2️⃣ 代码示例 (main.cpp)

复制代码

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

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

    // 1. 连接数据库
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName("test.db"); // 数据库文件，不存在会自动创建
    if (!db.open()) {
        qDebug() << "无法打开数据库:" << db.lastError().text();
        return -1;
    }

    QSqlQuery query;

    // 2. 创建表
    if (!query.exec("CREATE TABLE IF NOT EXISTS person ("
                    "id INTEGER PRIMARY KEY AUTOINCREMENT,"
                    "name TEXT,"
                    "age INTEGER)")) {
        qDebug() << "创建表失败:" << query.lastError().text();
    }

    // 3. 插入数据
    query.prepare("INSERT INTO person (name, age) VALUES (?, ?)");
    query.addBindValue("Alice");
    query.addBindValue(25);
    if (!query.exec())
        qDebug() << "插入数据失败:" << query.lastError().text();

    query.addBindValue("Bob");
    query.addBindValue(30);
    if (!query.exec())
        qDebug() << "插入数据失败:" << query.lastError().text();

    // 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 0;
}

🔑 关键点说明

数据库驱动：
- SQLite 驱动名是 QSQLITE，Qt 自带，无需额外安装。
自动创建文件：
- db.setDatabaseName("test.db") 如果文件不存在会自动生成。
参数绑定：
- 使用 query.prepare 和 query.addBindValue 可以避免 SQL 注入问题。

🖼️ 如果需要 UI 表格展示

可以直接在 QTableView 里显示：

复制代码

QSqlTableModel *model = new QSqlTableModel(this, db);
model->setTable("person");
model->select();
ui->tableView->setModel(model);

✅ 总结

最通用 ：QSqlDatabase + QSqlQuery，适合所有读写操作。
快速显示表格 ：QSqlTableModel + QTableView，适合简单的 CRUD 界面。