Win11 Python3.9 pip安装mysqlclient报legacy-install-failure错误

• 版本适配问题：mysqlclient==1.3.14是2018年发布的老旧版本，发布时间远早于Python 3.9、MySQL 8.0的正式发布时间，既没有适配Python 3.9的语法和ABI，也没有提供对应Windows平台的预编译wheel安装包，pip只能拉取源码包走本地编译流程。
• 安装流程问题：你当前虚拟环境未安装wheel包，pip触发了已被废弃的legacy setup.py install 安装逻辑，无法使用预编译包快速安装。
• 编译环境缺失：报错中X86\\x64\\cl.exe' failed with exit code 2是典型的Windows平台C编译环境缺失报错，本地没有安装配置微软Visual C生成工具链，源码编译过程无法正常执行。
• 输出中出现的setuptools关于dash-separated配置项命名的警告属于老版本setup.py的兼容提示，不是导致安装失败的原因。

方案一：安装适配当前环境的版本（推荐，无额外依赖） #

1. 先安装wheel组件，启用预编译包安装支持：

pip install wheel

2. 直接安装兼容Python 3.9、MySQL 8.0的mysqlclient稳定版，不要指定1.3.14的老旧版本号：

pip install mysqlclient

目前2.x分支的mysqlclient完全兼容你当前的Windows11 + Python3.9 + MySQL8.0环境，pip会自动拉取对应平台的预编译wheel包，不需要本地编译，安装后接口完全向下兼容老版本代码，无适配成本。如果项目有版本锁定要求，最低也要选择1.4.6及以上版本，该版本才开始加入对Python 3.9的支持。

方案二：强制安装1.3.14版本（不推荐，存在兼容风险） #

如果因特殊项目要求必须使用1.3.14版本，需要先补齐编译环境：

• 安装Visual Studio 生成工具，勾选「使用C++的桌面开发」组件，完成安装后重启终端保证环境变量生效
• 将本地MySQL 8.0安装目录下的bin、lib文件夹路径加入系统PATH环境变量，保证编译时能找到MySQL的头文件和链接库
• 重新执行pip install mysqlclient==1.3.14，注意该版本未适配Python3.9，编译过程中大概率出现语法报错，需要手动修改源码适配，流程繁琐且后续使用存在未知兼容问题、安全漏洞。

内容的提问来源于stack exchange，提问作者Remus Case