Qt中集成并使用SQLite數(shù)據(jù)庫的超完整指南
前言
SQLite 是一款輕量級(jí)、嵌入式的關(guān)系型數(shù)據(jù)庫，無需獨(dú)立的服務(wù)器進(jìn)程，數(shù)據(jù)以文件形式存儲(chǔ)，非常適合桌面和移動(dòng)端應(yīng)用的本地?cái)?shù)據(jù)管理。Qt 通過 Qt SQL 模塊提供了對(duì) SQLite 的原生支持，開發(fā)者可以輕松實(shí)現(xiàn)數(shù)據(jù)庫的增刪改查、事務(wù)處理等操作。本文將詳細(xì)介紹如何在 Qt 中集成并使用 SQLite 數(shù)據(jù)庫。
1. 環(huán)境配置與準(zhǔn)備工作
1.1 啟用 Qt SQL 模塊
在 Qt 項(xiàng)目文件（.pro）中添加 SQL 模塊依賴：
QT += sql
1.2 包含頭文件
在代碼中引入必要的類：
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>
#include <QSqlTableModel>
2. 連接 SQLite 數(shù)據(jù)庫
2.1 創(chuàng)建并打開數(shù)據(jù)庫
QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("my_database.db"); // 數(shù)據(jù)庫文件名（或完整路徑）
if (!db.open()) {
qDebug() << "Error: Failed to open database:" << db.lastError().text();
return;
}說明：
QSQLITE是 Qt 內(nèi)置的 SQLite 驅(qū)動(dòng)名稱。如果文件不存在，SQLite 會(huì)自動(dòng)創(chuàng)建新數(shù)據(jù)庫。
2.2 關(guān)閉數(shù)據(jù)庫
db.close(); // 顯式關(guān)閉連接（通常不需要，程序退出時(shí)自動(dòng)關(guān)閉）
3. 執(zhí)行 SQL 操作
3.1 創(chuàng)建表
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 插入數(shù)據(jù)
直接執(zhí)行 SQL
query.exec("INSERT INTO users (name, age, email) VALUES ('Alice', 30, 'alice@example.com')");使用預(yù)處理語句（防 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 查詢數(shù)據(jù)
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 更新與刪除數(shù)據(jù)
// 更新
query.exec("UPDATE users SET age = 31 WHERE name = 'Alice'");
// 刪除
query.exec("DELETE FROM users WHERE email IS NULL");4. 事務(wù)處理
通過事務(wù)確保多個(gè)操作的原子性：
db.transaction(); // 開始事務(wù)
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(); // 提交事務(wù)
} else {
db.rollback(); // 回滾事務(wù)
}5. 使用模型-視圖（Model-View）編程
Qt 提供了 QSqlTableModel 和 QSqlQueryModel，方便將數(shù)據(jù)庫與 UI 組件（如 QTableView）綁定。
5.1 顯示表格數(shù)據(jù)
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); // 用戶通過視圖修改數(shù)據(jù)后調(diào)用： model->submitAll(); // 提交所有更改到數(shù)據(jù)庫
6. 錯(cuò)誤處理與調(diào)試
6.1 捕獲數(shù)據(jù)庫錯(cuò)誤
if (!query.exec("INVALID SQL")) {
qDebug() << "SQL Error:" << query.lastError().text();
qDebug() << "Executed SQL:" << query.lastQuery();
}6.2 查看支持的數(shù)據(jù)庫驅(qū)動(dòng)
qDebug() << "Available drivers:" << QSqlDatabase::drivers();
// 輸出示例：("QSQLITE", "QMYSQL", "QPSQL")7. 高級(jí)技巧與注意事項(xiàng)
7.1 批量插入優(yōu)化
使用事務(wù)加速大批量插入：
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 默認(rèn)不支持多線程同時(shí)寫入，需通過
QSqlDatabase::cloneDatabase為每個(gè)線程創(chuàng)建獨(dú)立連接。在子線程中使用數(shù)據(jù)庫時(shí)，確保在子線程內(nèi)打開連接。
7.3 數(shù)據(jù)庫遷移
使用
user_version字段管理數(shù)據(jù)庫版本：query.exec("PRAGMA user_version = 1"); // 設(shè)置版本號(hào) query.exec("PRAGMA user_version"); // 讀取版本號(hào)
8. 常見問題解答
Q1：數(shù)據(jù)庫文件被鎖定了怎么辦？
確保所有
QSqlQuery和QSqlDatabase對(duì)象在使用后及時(shí)釋放。避免多線程同時(shí)寫入同一連接。
Q2：如何防止 SQL 注入？
始終使用
prepare()和addBindValue()替代字符串拼接。
Q3：查詢性能慢如何優(yōu)化？
為常用查詢字段添加索引。
減少頻繁的小事務(wù)，合并為批量操作。
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. 總結(jié)
Qt 的 SQLite 支持使得本地?cái)?shù)據(jù)管理變得簡單高效。核心要點(diǎn)包括：
使用
QSqlDatabase管理數(shù)據(jù)庫連接。通過
QSqlQuery執(zhí)行 SQL 語句并處理結(jié)果。利用事務(wù)保證數(shù)據(jù)一致性。
結(jié)合模型-視圖框架快速構(gòu)建 UI 界面。
官方文檔參考：
到此這篇關(guān)于Qt中集成并使用SQLite數(shù)據(jù)庫的文章就介紹到這了,更多相關(guān)Qt集成使用SQLite數(shù)據(jù)庫內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
- QT讀寫Sqlite數(shù)據(jù)庫的三種方式
- Qt操作SQLite數(shù)據(jù)庫的教程詳解
- Qt創(chuàng)建SQlite數(shù)據(jù)庫的示例代碼
- Qt使用SQLite數(shù)據(jù)庫實(shí)現(xiàn)數(shù)據(jù)增刪改查
- 一文教你Qt如何操作SQLite數(shù)據(jù)庫
- Qt實(shí)現(xiàn)將qsqlite數(shù)據(jù)庫中的數(shù)據(jù)導(dǎo)出為Excel表格
- Qt使用SQLite數(shù)據(jù)庫存儲(chǔ)管理圖片文件
- QT使用SQLite數(shù)據(jù)庫超詳細(xì)教程(增刪改查、對(duì)大量數(shù)據(jù)快速存儲(chǔ)和更新)
相關(guān)文章
C++實(shí)現(xiàn)學(xué)生成績管理系統(tǒng)最新版
這篇文章主要為大家詳細(xì)介紹了C++實(shí)現(xiàn)學(xué)生成績管理系統(tǒng)最新版，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2021-06-06
C語言實(shí)現(xiàn)簡單學(xué)生選課管理系統(tǒng)
這篇文章主要為大家詳細(xì)介紹了C語言實(shí)現(xiàn)簡單學(xué)生選課管理系統(tǒng)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2019-02-02
C語言實(shí)現(xiàn)手機(jī)電話簿管理系統(tǒng)
這篇文章主要為大家詳細(xì)介紹了C語言實(shí)現(xiàn)手機(jī)電話簿管理系統(tǒng)，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2022-06-06
指針在 C\C++ 語言中是很重要的內(nèi)容,并且和指針有關(guān)的內(nèi)容一向令初學(xué)者頭大,這篇文章主要給大家介紹了關(guān)于C/C++中指針的相關(guān)資料,需要的朋友可以參考下2021-07-07
這篇文章介紹了C語言計(jì)算Robots機(jī)器人行走路線，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-12-12
本文主要介紹了C++中auto關(guān)鍵字的使用，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-04-04
C語言保留字與標(biāo)識(shí)符規(guī)則的詳細(xì)指南
C語言作為一種高效、靈活的編程語言,其核心構(gòu)建塊——保留字和標(biāo)識(shí)符——構(gòu)成了代碼的骨架,本文將深入探討這些概念,輔以代碼示例、圖表和外部資源鏈接,助你全面掌握,需要的朋友可以參考下2026-03-03
本文給大家分享的是如何使用C語言的指針原來來實(shí)現(xiàn)語法樹，并給大家提供了詳細(xì)的實(shí)例代碼，希望大家能夠喜歡2019-02-02
在?Qml?中,矩形（Rectangle）是最常用的元素之一,本文將介紹如何通過自定義?Qml?元素實(shí)現(xiàn)一個(gè)任意角可為圓角的矩形,感興趣的可以了解下2025-01-01
這篇文章主要為大家詳細(xì)介紹了C語言圖書管理系統(tǒng)簡潔版，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2018-01-01