294 字
1 分钟
Python 中安装 mysqlclient
2025-05-22
2025-05-23

#

直接 pip install mysqlclient,安装报错:

Terminal window
......
building 'MySQLdb._mysql' extension
error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/visual-cpp-build-tools/
[end of output]
note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for mysqlclient
Failed to build mysqlclient
ERROR: ERROR: Failed to build installable wheels for some pyproject.toml based projects (mysqlclient)

提示需要安装 Microsoft C++ Build Tools

解决方法#

以下两个方法选择一种即可。

安装 Microsoft C++ Build Tools#

安装 Microsoft C++ 生成工具 - Visual Studio。安装过程中,请确保勾选了 C++ 生成工具(C++ Build Tools)组件。

使用预编译的二进制文件安装 mysqlclient#

使用提供的预编译版本来安装,例如使用 wheel 提供的 .whl 文件进行安装。

访问 mysqlclient · PyPI,在 Built Distributions 中找到对应 Python 版本和系统及芯片架构的包。

这里例如需要下载的是 mysqlclient-2.2.7-cp312-cp312-win_amd64.whl ,将下载的文件临时放到命令行所访问的根路径下,使用命令安装:

Terminal window
(django) PS D:\Alaye\GitHubDesktop\Playground\django-vue3-admin\backend>
pip install mysqlclient-2.2.7-cp312-cp312-win_amd64.whl

安装成功提示:

Terminal window
Processing d:\alaye\githubdesktop\playground\django-vue3-admin\backend\mysqlclient-2.2.7-cp312-cp312-win_amd64.whl
Installing collected packages: mysqlclient
Attempting uninstall: mysqlclient
Found existing installation: mysqlclient 2.2.4
Uninstalling mysqlclient-2.2.4:
Successfully uninstalled mysqlclient-2.2.4
Successfully installed mysqlclient-2.2.7

参考#

Python 中安装 mysqlclient
https://blog.alayedong.cn/posts/2025/install-mysqlclient-in-python/
作者
Alaye Dong
发布于
2025-05-22
许可协议
CC BY-NC-SA 4.0