一、在 Qt 中配置 MySQL
1.1 常见问题与解决方法
1.1.1 遇到的问题
- 没有 Src 目录
- MSVC 2017 显示黄色感叹号
- 编译时报找不到 cmake.exe
1.1.2 问题原因分析
第 3 个问题可能的原因:
- 仅安装了 Qt Creator 而未安装 Qt SDK(含 MinGW/MSVC 等编译器)
- 已安装编译器但未添加到系统 PATH
- CMake 未安装或路径未在 Qt Creator 中注册
1.1.3 解决方案
下载源码:在网上直接下载对应版本的源码,复制到 Qt 安装目录下即可。
- 下载地址:https://download.qt.io/archive/qt/
解决 MSVC 构建器感叹号:参照下方文章设置
https://blog.csdn.net/qq_41839588/article/details/135612963
解决 CMake 问题:
- 步骤 1:确认已安装对应平台的编译器(如 Windows 下安装 Visual Studio 或 MinGW,并勾选 C++ 工作负载)
- 步骤 2:安装独立 CMake(推荐官网版本,避免使用包管理器安装的精简版)
- 步骤 3:启动 Qt Creator →Tools → Options → Kits,在 “Compilers” 页添加编译器,在 “CMake” 页指定 cmake.exe 路径,在 “Kits” 页绑定编译器、CMake 与 Qt 版本
- 额外建议:若仍无效,可重启 Qt Creator 并检查日志输出(Help → About Plugins → Show Details)
建议:优先使用在线安装程序(Qt Online Installer),它能一站式部署 Qt、编译器和 CMake。
1.2 编译 MySQL 驱动
解决完上述问题之后,就可以开始编译了。
1.2.1 步骤一:定位 mysql.pro 文件
首先找到 Src 目录下的 mysql.pro 文件,路径例如:D:\Qt\Qt5.14.2\Src\qtbase\src\plugins\sqldrivers\mysql
1.2.2 步骤二:编辑 mysql.pro 文件
右键编辑 mysql.pro 文件:
- 注释掉
QMAKE_USE += mysql - 添加 MySQL 的 include 库和 libmysql.lib
1.2.3 步骤三:修改 qsqldriverbase.pri 文件
注释掉 include 那行
1.2.4 步骤四:编译生成驱动
在 Qt Creator 中打开 mysql.pro 文件,编译生成对应编译器的驱动:
- 选择 MSVC 编译器
- 分别用 debug 和 release 进行编译
编译成功的话,去安装 Qt 的根目录找 plugins 文件夹,一共生成九个文件,我们需要如下两个:
1.2.5 步骤五:复制文件
复制驱动文件:把上面生成的两个驱动粘贴到 Qt 的 sqldrivers 目录下
复制 DLL 文件:把你电脑上 MySQL 文件夹下的 libmysql.dll 复制到 Qt 对应编译器的 bin 目录下
二、在 VS 2022 中配置 Qt 和 MySQL
2.1 安装 Qt VS Tools
注意:点击下载后,需要先关闭 VS,等待下载完再打开。
2.2 配置 Qt Version
安装完成后就能在扩展选项中看到了,我们点击 Qt Versions 去设置相关参数。
选择对应的编译器版本:
2.3 添加 include 目录和 library 目录
注意:每一个你要用到 MySQL 的项目中都需要配置。
右键项目名,选择属性
在包含目录和库目录中加入 MySQL 以及 Qt 的路径
2.4 在链接库中添加对应的 lib 文件
2.5 在 Qt 的设置中添加 sql 模块
三、配置完成
至此就可以在项目中建立 Qt 以及 MySQL 的连接了。