Qt + SQLite 配置与使用指南

Qt SQLite 配置与使用指南1.1 Qt 工程配置.pro 文件打开项目的 .pro 文件在原有模块后追加 sqlQT core gui serialport sql必须重新执行 qmake在 Qt Creator 中右键项目 →执行 qmake然后重新构建。否则编译器会报找不到 QSqlDatabase 等头文件。验证 SQLite 驱动是否加载成功可在 main.cpp 或任意窗口中加一段测试代码#includeQSqlDatabase#includeQDebug//打印所有可用的数据库驱动qDebug() QSqlDatabase::drivers();//正常应输出列表中包含 QSQLITE若列表中没有 QSQLITE请检查是否正确添加了 QT sql 并重新 qmake。若使用静态编译的 Qt需要手动链接 SQLite 插件动态编译的 Qt官方安装版默认通常自带。1.2 SQLite 可视化工具安装DB Browser for SQLite项目运行后会生成 .db 文件直接用文本编辑器打开是乱码建议安装可视化工具查看。推荐工具DB Browser for SQLite官网下载https://sqlitebrowser.org/dl/Windows 用户直接下载 DB.Browser.for.SQLite-v3.x.x-win64.exe 安装包按向导安装即可。基本使用步骤打开数据库文件点击打开数据库选择项目运行目录下的 device_data.db。浏览数据切换到浏览数据标签选择表 device_data即可查看所有已存储的记录。执行 SQL切换到执行 SQL标签可手写查询语句例如*FROMdevice_dataORDERBYtimestampDESCLIMIT10;导出数据在浏览数据界面右键 → 导出结果可导出为 CSV/Excel方便后续分析。替代工具SQLiteStudiohttps://sqlitestudio.pl功能类似按个人习惯选择即可。1.3 常见环境排错现象原因解决QSqlDatabase: QSQLITE driver not loaded未加 QT sql 或未重新 qmake检查 .pro重新 qmake → 重新构建程序启动后找不到 .db 文件使用的是相对路径 device_data.db文件实际生成在可执行程序所在目录build 目录而非源码目录但可使用代码指定生成目录可视化工具提示数据库被锁定Qt 程序正在运行并占用数据库关闭 Qt 程序后再用 DB Browser 打开或在代码中使用 m_db.close() 后查看