Qt连接MySQL数据库的完整使用指南
要在Qt中连接并使用MySQL数据库,首先需要确保正确配置开发环境,并通过Qt提供的数据库模块进行连接与操作,以下是详细步骤与关键要点:

环境准备与驱动配置
- 安装MySQL数据库:确保本地或远程已安装MySQL,并记录主机地址、端口、数据库名称、用户名和密码。
- 编译MySQL驱动:Qt默认可能不包含MySQL驱动,需手动编译,在Qt安装目录的
Src/qtbase/src/plugins/sqldrivers/mysql中,使用qmake和make工具生成qsqlmysql.dll(Windows)或qsqlmysql.so(Linux/macOS)文件,并将其复制到Qt的插件目录plugins/sqldrivers/下。 - 添加依赖库:将MySQL的
libmysql.dll(Windows)或libmysqlclient.so(Linux)放置到系统路径或项目运行目录中。
在Qt项目中连接MySQL
-
引入数据库模块:在项目文件(.pro)中添加
QT += sql。 -
代码实现连接:
#include <QSqlDatabase> #include <QSqlError> #include <QDebug> QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL"); // 指定MySQL驱动 db.setHostName("localhost"); // 主机地址 db.setPort(3306); // 端口 db.setDatabaseName("test_db"); // 数据库名 db.setUserName("root"); // 用户名 db.setPassword("123456"); // 密码 if (db.open()) { qDebug() << "MySQL连接成功!"; } else { qDebug() << "连接失败:" << db.lastError().text(); }
执行SQL操作
连接成功后,可使用QSqlQuery执行查询或操作:
QSqlQuery query;
query.exec("SELECT * FROM users");
while (query.next()) {
QString name = query.value("name").toString();
qDebug() << name;
}
常见问题与注意事项
- 驱动加载失败:检查驱动文件是否放置正确,或尝试用
QSqlDatabase::drivers()查看可用驱动列表。 - 连接超时:确认MySQL服务已启动,且网络和权限设置允许远程访问。
- 中文乱码:在连接前设置
db.setConnectOptions("MYSQL_OPT_SET_CHARSET_NAME=utf8");。
通过以上步骤,即可在Qt中高效集成MySQL数据库,实现数据的增删改查功能。
未经允许不得转载! 作者:HTML前端知识网,转载或复制请以超链接形式并注明出处HTML前端知识网。
原文地址:https://www.html4.cn/12222.html发布于:2026-08-21





