如何在Python 3.14中成功安装mathutils库？

一、确保安装最新适配版本 #

PyPI上的mathutils包大概率未同步到支持Python 3.14的最新代码，不要使用默认的pip install mathutils，直接从GitHub拉取官方最新源码安装：

• 直接通过pip安装源码：

  pip install git+https://github.com/ideasman42/mathutils.git
  

• 若仍提示Eigen依赖问题，先递归克隆仓库（包含Eigen子模块）再本地安装：

  git clone --recursive https://github.com/ideasman42/mathutils.git
  cd mathutils
  pip install .
  

二、解决Eigen头文件缺失问题 #

mathutils编译依赖Eigen线性代数库，系统未预装时需手动安装：

• Linux（Debian/Ubuntu）：

  sudo apt-get install libeigen3-dev
  

• macOS：

  brew install eigen
  

• Windows：
  使用vcpkg安装Eigen：

  vcpkg install eigen3
  

  安装后确保编译环境能识别Eigen路径，再执行本地安装命令。

三、避免给协作人员带来繁琐依赖的方案 #

1. 预编译wheel包：
   自行编译适配Python 3.14的mathutils wheel文件（编译后生成在dist目录），共享给团队成员，他们只需执行：

   pip install path/to/mathutils-xxx-py3-none-any.whl
   

   无需处理编译依赖。
2. 使用Docker镜像：
   构建包含Python 3.14、mathutils及所有依赖的Docker镜像，团队成员直接基于镜像运行项目，无需本地安装任何依赖。
3. 复用Blender内置mathutils：
   若项目与Blender相关，直接使用Blender 5.1自带的Python环境（已适配Python 3.14），该环境内置mathutils，无需单独安装。

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