Python项目安装依赖时matplotlib构建wheel失败求助

核心原因 #

错误提示command 'msbuild' failed: None，要么是系统缺少MSBuild编译工具，要么是你指定的matplotlib 3.3.2版本与Python 3.10存在兼容性问题（3.3.2发布时Python3.10还未推出）。

实用解决办法 #

1. 直接安装预编译wheel（最快解决） #

强制pip使用预编译的二进制包，跳过源码编译环节，执行以下命令：

pip install matplotlib==3.3.2 --only-binary :all:

2. 配置MSBuild编译环境（适合一定要源码编译的场景） #

• 下载Visual Studio Installer，勾选「桌面开发使用C++」组件，必须包含MSBuild工具和VC++ 2010兼容工具集（因为编译脚本调用的是VC2010的解决方案）。
• 安装完成后，找到MSBuild的安装路径（例如C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin），将其添加到系统环境变量PATH中，重启命令行后重新执行依赖安装。

3. 升级matplotlib版本（长期最优方案） #

matplotlib 3.3.2不支持Python3.10，将requirements.txt中的matplotlib版本改为3.4.0及以上（官方从3.4.0开始适配Python3.10），再执行：

pip install -r requirements.txt

内容的提问来源于stack exchange，提问作者Ser Ms