Qt 4 連接 MySQL 驅動編譯全記錄（Windows + VS2010）

環境清單

• OS：Windows 7
• 編譯器：MSVC (Visual Studio 2010)
• Qt：4.x（需源碼包含 src/plugins/sqldrivers/mysql）
• MySQL：5.5（含 include、lib/opt/libmysql.lib）

編譯步驟

1. 進入驅動源碼目錄

   cd %QTDIR%\src\plugins\sqldrivers\mysql
   

2. 生成 Makefile（路徑不能包含空格，否則編譯失敗）

   qmake -o Makefile "INCLUDEPATH+=C:\MySQL\include" "LIBS+=C:\MySQL\lib\opt\libmysql.lib" mysql.pro
   

   若 MySQL 安裝路徑有空格，請將 include、lib 複製至無空格路徑（如 D:\work），改為：

   qmake -o Makefile "INCLUDEPATH+=D:\work\include" "LIBS+=D:\work\lib\libmysql.lib" mysql.pro
   

3. 編譯

   nmake
   

   產出：debug/qsqlmysqld4.dll、debug/qsqlmysqld4.lib

4. 部署：將上述兩文件複製至 %QTDIR%\plugins\sqldrivers\

常見坑

• 路徑含空格 → 編譯報錯「No such file or directory」
• Qt 版本與 MySQL 位數不匹配（x86/x64） → 運行時「Driver not loaded」
• 缺少 libmysql.dll → 需放入應用同目錄或系統 PATH