Win10 VS Code Flask虚拟环境安装flask-mysqldb时mysqlclient编译失败求助

核心问题 #

报错中fatal error C1083: No se puede abrir el archivo incluir: 'mysql.h': No such file or directory明确说明：编译mysqlclient时找不到MySQL/MariaDB的C开发头文件，flask-mysqldb依赖mysqlclient，而Windows环境下默认需要手动提供对应的编译依赖。

可行解决方案 #

方案1：安装预编译的mysqlclient轮子（无需本地编译） #

跳过编译步骤，直接使用官方预编译的二进制包：

• 执行命令强制调用预编译版本：

  pip install --only-binary :all: mysqlclient flask-mysqldb
  

• 若上述命令失败，手动下载与你的Python版本（如3.12）、系统位数（64位）匹配的mysqlclient预编译.whl文件，再本地安装：

  pip install mysqlclient-2.2.0-cp312-cp312-win_amd64.whl
  pip install flask-mysqldb
  

  注意替换命令中的文件名与你实际下载的版本一致。

方案2：安装MariaDB Connector/C并指定编译路径 #

报错日志已尝试查找MariaDB Connector路径，可通过安装完整开发组件解决：

1. 安装MariaDB Connector/C，安装过程中务必勾选「开发组件」选项，确保包含头文件和库文件。
2. 执行安装命令时手动指定include和lib路径（替换为你的实际安装路径）：

   pip install flask-mysqldb --global-option=build_ext --global-option="-IC:/Program Files/MariaDB/MariaDB Connector C/include" --global-option="-LC:/Program Files/MariaDB/MariaDB Connector C/lib/mariadb"
   

方案3：检查Visual Studio Build Tools组件 #

确认你的Visual Studio Build Tools已安装完整的C++开发环境：

1. 打开Visual Studio Installer，选择「修改」已安装的Build Tools。
2. 确保勾选**Desktop development with C++**组件，包含MSVC v143工具链、Windows SDK等核心组件，完成安装后重启终端再尝试安装。

方案4：改用无需编译的替代库pymysql #

若以上方案均无效，可替换底层驱动绕开编译问题：

1. 安装依赖：

   pip install pymysql flask-mysqldb
   

2. 在Flask项目的入口文件（如app.py）顶部添加以下代码，让flask-mysqldb使用pymysql替代mysqlclient：

   import pymysql
   pymysql.install_as_MySQLdb()
   

内容的提问来源于stack exchange，提问作者Taty Skellingtøn