You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

宣称支持Python 3.14的mathutils库pip安装失败的技术咨询

Python 3.14下安装mathutils失败的排查与解决

Hey there, 我完全懂你现在的困扰——明明mathutils官方更新说支持Python 3.14了,但在Windows上用pip install还是一堆编译报错,太闹心了。咱们从报错日志里抓关键点来解决:

从你贴的编译日志能看到几个核心问题:

  1. 编译脚本在找/usr/include/eigen3——这是Linux系统的路径,但你是Windows环境,肯定找不到这个路径,这是编译失败的主要原因之一
  2. 虽然你有VS 2022的编译环境,但可能依赖库的配置没跟上Windows的要求

可行的解决方案

1. 手动指定Eigen3的Windows路径

mathutils依赖Eigen3线性代数库,Windows下默认没有这个系统级路径,你得手动安装并指定:

  • 先下载Eigen最新稳定版(建议3.4.x),解压到本地任意路径,比如C:\libs\eigen-3.4.0
  • 安装时通过pip的编译选项指定Eigen的include路径:
    pip install mathutils --global-option=build_ext --global-option="-IC:\libs\eigen-3.4.0"
    

2. 跳过源码编译,用预编译Wheel包

Windows下C++扩展的源码编译经常踩环境坑,直接用预编译的wheel会省心很多:

  • 找找针对Python 3.14的Windows版mathutils wheel包(可以搜专门提供Python第三方预编译包的国内或国际镜像站点)
  • 下载对应你系统架构(x64)的.whl文件后,直接用pip安装:
    pip install mathutils-5.1.0-cp314-cp314-win_amd64.whl
    

3. 检查VS编译环境是否完整

确保你的VS 2022配置正确:

  • 打开Visual Studio Installer,确认勾选了「使用C++的桌面开发」工作负载
  • 检查是否安装了报错里提到的Windows 10 SDK版本(10.0.26100.0),如果没有就补上

你的报错日志

Collecting mathutils
Using cached mathutils-5.1.0.tar.gz (350 kB)
Installing build dependencies ... done
Getting requirements to build wheel ... done
Preparing metadata (pyproject.toml) ... done
Building wheels for collected packages: mathutils
Building wheel for mathutils (pyproject.toml) ... error
error: subprocess-exited-with-error
× Building wheel for mathutils (pyproject.toml) did not run successfully.
│ exit code: 1
╰─> [73 lines of output]
running bdist_wheel
running build
running build_ext
building 'mathutils' extension
creating build\temp.win-amd64-cpython-314\Release\src\blenlib\intern
creating build\temp.win-amd64-cpython-314\Release\src\generic
creating build\temp.win-amd64-cpython-314\Release\src\mathutils
creating build\temp.win-amd64-cpython-314\Release\src\stubs
"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.38.33130\bin\HostX86\x64\cl.exe" /c /nologo /O2 /W3 /GL /DNDEBUG /MD -DMATH_STANDALONE -DWITH_ASSERT_ABORT -Isrc/stubs -Isrc/blenlib -Isrc/makesdna -Isrc/generic -I/usr/include/eigen3 -IC:\Dev\maps.venv\include -IC:\Users\jphda\AppData\Local\Python\pythoncore-3.14-64\include -IC:\Users\jphda\AppData\Local\Python\pythoncore-3.14-64\Include "-IC:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.38.33130\include" "-IC:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.38.33130\ATLMFC\include" "-IC:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\VS\include" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\ucrt" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\um" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\shared" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\winrt" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\cppwinrt" "-IC:\Program Files (x86)\Windows Kits\NETFXSDK\4.8\include\um" /EHsc /Tpsrc/blenlib/intern/BLI_assert.cc /Fobuild\temp.win-amd64-cpython-314\Release\src\blenlib\intern\BLI_assert.obj /J /std:c20 -D__LITTLE_ENDIAN__
BLI_assert.cc
"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.38.33130\bin\HostX86\x64\cl.exe" /c /nologo /O2 /W3 /GL /DNDEBUG /MD -DMATH_STANDALONE -DWITH_ASSERT_ABORT -Isrc/stubs -Isrc/blenlib -Isrc/makesdna -Isrc/generic -I/usr/include/eigen3 -IC:\Dev\maps.venv\include -IC:\Users\jphda\AppData\Local\Python\pythoncore-3.14-64\include -IC:\Users\jphda\AppData\Local\Python\pythoncore-3.14-64\Include "-IC:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.38.33130\include" "-IC:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.38.33130\ATLMFC\include" "-IC:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\VS\include" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\ucrt" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\um" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\shared" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\winrt" "-IC:\Program Files (x86)\Windows Kits\10\include\10.0.26100.0\cppwinrt" "-IC:\Program Files (x86)\Windows Kits\NETFXSDK\4.8\include\um" /EHsc /Tpsrc/blenlib/intern/math_base.cc /Fobuild\temp.win-amd64-cpython-314\Release\src\blenlib\intern\math_base.obj /J /std:c
20 -D__LITTLE_ENDIAN__
math_base.cc

内容的提问来源于stack exchange,提问作者Jules

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.27 09:13:12