Python3.10环境下安装mysqlclient、mysql包提示缺失mysql.h问题求助

报错根因 #

mysqlclient是基于C语言扩展实现的Python包，直接通过pip从源码安装时，要求本地环境同时具备MySQL C开发依赖（包含mysql.h头文件、对应动态链接库）和完整的VC++编译环境，本次报错就是本地缺失mysql.h头文件导致编译流程中断。另外你尝试安装的mysql包已停止维护多年，无需再尝试安装该包。

解决方案（按操作便捷度排序） #

方案一：使用纯Python实现的兼容包替代（无需编译，零配置） #

直接安装纯Python实现的pymysql，它和mysqlclient的接口完全兼容，不需要任何编译依赖：

• 执行安装命令：
  pip install pymysql
• 在你的项目入口文件（比如框架启动文件、项目根目录的__init__.py）中添加如下两行代码，即可让所有依赖MySQLdb的代码无需修改直接运行：

  import pymysql
  pymysql.install_as_MySQLdb()
  

方案二：安装mysqlclient预编译二进制包（无需处理编译依赖） #

直接拉取官方预编译好的wheel包，跳过源码编译步骤：

• 确认你的Python 3.10是64位版本（当前大部分Windows安装的Python都是64位，如果是32位可自行调整对应版本）
• 执行安装命令：
  pip install mysqlclient --only-binary :all:

方案三：从源码编译安装（适合需要原生mysqlclient的场景） #

如果一定要使用原生mysqlclient，需要先安装对应依赖：

• 下载安装MySQL Connector/C 8.0版本，安装时选择默认路径即可
• 重新执行pip install mysqlclient即可正常完成编译安装

内容的提问来源于stack exchange，提问作者P-CAST