C++ Qt数据库编程完全指南（从零开始掌握Qt与MySQL的交互）

一、准备工作：安装与配置

要使用 Qt连接MySQL，你需要完成以下步骤：

1. 安装 Qt（建议使用 Qt 5.15 或 Qt 6.x 版本）
2. 安装 MySQL 服务器（或使用本地已有的数据库）
3. 确保 Qt 的 SQL 模块已启用（默认包含）
4. （可选）下载并配置 MySQL 驱动（Qt 安装包通常自带）

你可以在 Qt Creator 的项目文件（.pro）中添加以下行来启用 SQL 模块：

QT += sql

二、连接数据库

在 Qt 中，我们使用 QSqlDatabase 类来管理数据库连接。下面是一个连接 MySQL 数据库的完整示例：

#include <QCoreApplication>#include <QSqlDatabase>#include <QSqlError>#include <QDebug>int main(int argc, char *argv[]){    QCoreApplication a(argc, argv);    // 添加 MySQL 数据库驱动    QSqlDatabase db = QSqlDatabase::addDatabase("QMYSQL");    db.setHostName("localhost");      // 数据库主机地址    db.setPort(3306);                 // MySQL 默认端口    db.setDatabaseName("testdb");     // 数据库名称    db.setUserName("root");           // 用户名    db.setPassword("your_password");  // 密码    // 尝试打开连接    if (!db.open()) {        qDebug() << "数据库连接失败:" << db.lastError().text();        return -1;    }    qDebug() << "数据库连接成功！";    return 0;}

注意：如果你使用的是 SQLite，只需将驱动改为 "QSQLITE" 并设置数据库文件路径即可，无需用户名和密码。

三、执行 SQL 查询：增删改查（CRUD）

一旦连接成功，就可以使用 QSqlQuery 执行 SQL 语句。以下是常见的操作示例：

1. 创建表

QSqlQuery query;query.exec("CREATE TABLE IF NOT EXISTS users ("           "id INTEGER PRIMARY KEY AUTO_INCREMENT, "           "name VARCHAR(50), "           "email VARCHAR(100))");

2. 插入数据

QSqlQuery query;query.prepare("INSERT INTO users (name, email) VALUES (?, ?)");query.addBindValue("张三");query.addBindValue("zhangsan@example.com");query.exec();

3. 查询数据

QSqlQuery query("SELECT id, name, email FROM users");while (query.next()) {    int id = query.value(0).toInt();    QString name = query.value(1).toString();    QString email = query.value(2).toString();    qDebug() << "ID:" << id << ", 姓名:" << name << ", 邮箱:" << email;}

4. 更新与删除

// 更新query.prepare("UPDATE users SET email = ? WHERE id = ?");query.addBindValue("newemail@example.com");query.addBindValue(1);query.exec();// 删除query.exec("DELETE FROM users WHERE id = 1");

四、常见问题与调试技巧

在进行 Qt数据库开发入门 时，可能会遇到以下问题：

• 驱动未加载：确保 Qt 安装目录下的 plugins/sqldrivers/ 中有 qsqlmysql.dll（Windows）或 libqsqlmysql.so（Linux）
• 连接被拒绝：检查 MySQL 是否运行，防火墙是否阻止端口，用户名/密码是否正确
• 中文乱码：在连接后执行 SET NAMES utf8mb4 设置字符集

五、总结

通过本教程，你已经掌握了 Qt SQL操作教程 的核心内容：从环境配置、数据库连接到基本的 CRUD 操作。Qt 的 SQL 模块设计简洁、功能强大，非常适合用于桌面应用的数据持久化开发。

下一步，你可以尝试将数据库操作与 Qt 的 GUI 组件（如 QTableView + QSqlTableModel）结合，构建完整的数据管理界面。

希望这篇 C++ Qt数据库编程 教程能帮助你顺利入门！如有疑问，欢迎在评论区留言交流。