Windows嵌入式Python 3.10安装Spleeter遇No module named 'src'错误求助

可行解决方案 #

方案1：直接安装future预编译wheel包

嵌入式Python环境下源码构建future包会触发路径问题，可跳过源码编译直接用预编译包：

• 下载对应Python版本的future whl文件（如Python3.10对应future-0.18.3-cp310-none-any.whl）
• 执行命令安装future：

  python.exe -m pip install 本地路径\future-0.18.3-cp310-none-any.whl
  

• 再执行python.exe -m pip install spleeter完成安装

方案2：修正嵌入式Python的路径配置

调整python310._pth文件的路径设置，解决site-packages的路径识别问题：

• 打开python310._pth，将Lib\site-packages改为绝对路径（例如C:\your-python-folder\Lib\site-packages）
• 在文件末尾添加import site（确保site模块正常加载）
• 保存后重新尝试安装Spleeter

方案3：替换为完整Python环境

嵌入式Python为轻量场景设计，缺少部分标准库支持，对于依赖复杂的Spleeter，更推荐使用完整Python安装包：

• 从官方下载对应版本的Python exe安装程序，完成安装
• 直接执行pip install spleeter即可正常完成依赖安装

错误原因分析 #

嵌入式Python默认未启用完整的site模块，路径解析逻辑与标准Python不同。安装future包时，其构建脚本尝试从src目录读取元数据，但嵌入式环境下无法正确识别该路径，导致ModuleNotFoundError。所谓的“src包”并非标准PyPI包，而是部分项目的源码目录命名，因此单独安装无效。

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