VS2022+Qt5.14.2+MySQL8.0完美配置指南
2026/7/14 20:20:44 网站建设 项目流程

一、在 Qt 中配置 MySQL

1.1 常见问题与解决方法

1.1.1 遇到的问题
  1. 没有 Src 目录
  2. MSVC 2017 显示黄色感叹号
  3. 编译时报找不到 cmake.exe
1.1.2 问题原因分析

第 3 个问题可能的原因:

  • 仅安装了 Qt Creator 而未安装 Qt SDK(含 MinGW/MSVC 等编译器)
  • 已安装编译器但未添加到系统 PATH
  • CMake 未安装或路径未在 Qt Creator 中注册
1.1.3 解决方案
  1. 下载源码:在网上直接下载对应版本的源码,复制到 Qt 安装目录下即可。

    • 下载地址:https://download.qt.io/archive/qt/
  2. 解决 MSVC 构建器感叹号:参照下方文章设置

    https://blog.csdn.net/qq_41839588/article/details/135612963

  3. 解决 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 文件:

  1. 注释掉QMAKE_USE += mysql
  2. 添加 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 步骤五:复制文件
  1. 复制驱动文件:把上面生成的两个驱动粘贴到 Qt 的 sqldrivers 目录下

  2. 复制 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 的项目中都需要配置。

  1. 右键项目名,选择属性

  2. 在包含目录和库目录中加入 MySQL 以及 Qt 的路径

2.4 在链接库中添加对应的 lib 文件

2.5 在 Qt 的设置中添加 sql 模块

三、配置完成

至此就可以在项目中建立 Qt 以及 MySQL 的连接了。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询