Qt + SQLite 配置与使用指南

Qt + SQLite 配置与使用指南

1.1 Qt 工程配置（.pro 文件）

打开项目的 .pro 文件，在原有模块后追加 sql：

QT+= core gui serialport sql

必须重新执行 qmake：在 Qt Creator 中右键项目 →执行 qmake，然后重新构建。否则编译器会报找不到 QSqlDatabase 等头文件。

验证 SQLite 驱动是否加载成功，可在 main.cpp 或任意窗口中加一段测试代码：

#include<QSqlDatabase>
#include<QDebug>

//打印所有可用的数据库驱动
qDebug() << QSqlDatabase::drivers();
//正常应输出列表中包含 "QSQLITE"

若列表中没有 QSQLITE，请检查：

1. 是否正确添加了 QT += sql 并重新 qmake。
2. 若使用静态编译的 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 安装包，按向导安装即可。

基本使用步骤

1. 打开数据库文件：点击打开数据库，选择项目运行目录下的 device_data.db。
2. 浏览数据：切换到浏览数据标签，选择表 device_data，即可查看所有已存储的记录。
3. 执行 SQL：切换到执行 SQL标签，可手写查询语句，例如：

1. *FROMdevice_dataORDERBYtimestampDESCLIMIT10;

1. 导出数据：在浏览数据界面右键 → 导出结果，可导出为 CSV/Excel，方便后续分析。

替代工具：SQLiteStudio（https://sqlitestudio.pl），功能类似，按个人习惯选择即可。

1.3 常见环境排错