安装SubmodLib失败求助：两种官方安装方式均无效

1. 补全编译环境 #

无法构建wheel包大概率是缺少系统级编译工具，按你的系统对应操作：

• Linux（Debian/Ubuntu）：安装基础编译套件

  sudo apt-get install build-essential
  

• Linux（RHEL/CentOS）：安装C++编译工具

  sudo dnf install gcc-c++
  

• Windows：安装Visual Studio Build Tools，勾选「C++开发工具」组件
• macOS：安装Xcode命令行工具

  xcode-select --install
  

2. 升级pip、setuptools、wheel #

旧版本工具可能不支持新项目的构建规范：

pip install --upgrade pip setuptools wheel

3. 带日志重新尝试源码安装 #

通过详细日志定位具体错误：

git clone https://github.com/decile-team/submodlib.git
cd submodlib
pip install . -v

查看日志里的报错信息，比如是否存在依赖版本不兼容、缺少线性代数库（如BLAS/LAPACK）等问题，针对性解决。

4. 严格匹配依赖版本 #

查看项目根目录的requirements.txt或pyproject.toml文件，确认所有依赖的版本要求，手动安装对应版本：

# 示例：若要求numpy>=1.21.0，执行
pip install numpy>=1.21.0

5. 用虚拟环境隔离安装 #

避免全局环境的依赖冲突：

# 创建虚拟环境
python -m venv submodlib_env
# 激活虚拟环境
# Linux/macOS
source submodlib_env/bin/activate
# Windows
submodlib_env\Scripts\activate
# 重新执行安装命令
pip install .

6. 手动编译并添加路径 #

如果上述方法都无效，尝试直接编译源码并手动添加到Python路径：

cd submodlib
# 原地编译扩展
python setup.py build_ext --inplace
# 添加当前目录到Python路径
# Linux/macOS
export PYTHONPATH=$(pwd):$PYTHONPATH
# Windows
set PYTHONPATH=%cd%;%PYTHONPATH%

之后即可在Python中尝试导入submodlib。

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