Windows11下pip安装mysqlclient遇C1083错误：找不到mysql.h

问题详情 #

在Windows 11 22621版本执行pip install mysqlclient时触发报错：

• 构建mysqlclient的wheel失败，子进程退出码为1
• 编译扩展模块阶段，src/MySQLdb/_mysql.c(29)出现fatal error C1083，提示无法打开头文件mysql.h，导致cl.exe命令执行失败
• 已尝试Stack Overflow常规方案但未解决，完整错误片段如下：

扩展模块构建选项： #

library_dirs: ['C:/mariadb-connector\lib\mariadb', 'C:/mariadb-connector\lib']
libraries: ['kernel32', 'advapi32', 'wsock32', 'shlwapi', 'Ws2_32', 'crypt32', 'secur32', 'bcrypt', 'mariadbclient']
extra_link_args: ['/MANIFEST']
include_dirs: ['C:/mariadb-connector\include\mariadb', 'C:/mariadb-connector\include']
extra_objects: []
define_macros: [('version_info', (2, 2, 0, 'final', 0)), ('version', '2.2.0')]
running bdist_wheel
running build
running build_py
...（后续编译步骤略）
src/MySQLdb/_mysql.c(29): fatal error C1083: Cannot open include file: 'mysql.h': No such file or directory
error: command 'C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.37.32822\bin\HostX86\x64\cl.exe' failed with exit code 2

针对性解决步骤 #

1. 核查MariaDB Connector/C安装有效性 #

• 检查C:/mariadb-connector/include目录下是否存在mysql.h，若缺失，重新下载x64架构的MariaDB Connector/C稳定版（推荐1.11.x系列）
• 安装时选择完整安装，确保include、lib目录文件齐全，且安装路径为纯英文无空格（如C:\mariadb-connector）

2. 手动指定编译环境变量 #

打开管理员权限的命令提示符，执行以下命令（替换为你的实际安装路径）：

set MYSQLCLIENT_CFLAGS="-IC:\mariadb-connector\include"
set MYSQLCLIENT_LDFLAGS="-LC:\mariadb-connector\lib -lmariadbclient"

之后再执行安装命令：

pip install mysqlclient

3. 替代方案：使用预编译wheel包 #

若编译持续失败，直接下载对应Python版本与系统架构的mysqlclient预编译.whl文件，执行安装：

pip install 你的wheel文件名.whl

4. 检查VS Build Tools组件完整性 #

确认Visual Studio 2022 Build Tools已安装以下组件：

• MSVC v143生成工具
• 对应Windows 11版本的Windows SDK
• C++标准库组件

内容的提问来源于stack exchange，提问作者Adnan Nazir