升级Python至3.11.2后运行Manim报错：mapbox_earcut DLL加载失败

问题分析 #

Python版本升级到3.11.2后，mapbox_earcut作为带原生扩展的依赖包，其预编译的wheel文件可能与新Python版本的ABI（应用二进制接口）不兼容，导致DLL加载失败；且重装时可能未正确清理旧残留或编译新的适配文件。

解决方案 #

1. 彻底清理旧安装残留 #

• 执行卸载命令：

  pip uninstall -y mapbox_earcut
  

• 手动检查Python的site-packages目录（路径为C:\Users\_\AppData\Local\Programs\Python\Python311\Lib\site-packages），删除所有包含mapbox_earcut字样的文件/文件夹（如.egg-info后缀的文件），确保无残留。

2. 安装C++编译依赖（Windows环境） #

mapbox_earcut从源码编译需要C++构建工具：

• 下载并安装Microsoft Visual C++ Build Tools，安装时勾选「Desktop development with C++」组件，完成后重启终端。

3. 强制从源码编译安装 #

执行以下命令，强制pip从源码编译适配Python3.11的版本：

pip install --no-binary :all: mapbox_earcut

4. 验证安装结果 #

打开Python交互终端，输入：

import mapbox_earcut

若未抛出错误，说明安装成功，重新运行Manim即可。

备选方案 #

如果上述步骤无效：

• 检查Manim版本是否兼容Python3.11，升级Manim到最新稳定版：pip install --upgrade manim
• 若仍存在兼容性问题，可考虑临时降级Python到3.10版本（该版本对mapbox_earcut的支持更成熟）

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