使用Numpy 2.x导入CatBoostClassifier遇二进制不兼容错误求助

问题原因 #

该报错是因为CatBoost的预编译包基于旧版Numpy的ABI（应用二进制接口）构建，Numpy 2.x的ABI发生了变更，导致二进制不兼容；即使降级Numpy，若环境存在依赖残留或未使用隔离环境，也可能导致问题持续。

解决方案 #

1. 彻底清理依赖并重新安装 #

• 完全卸载现有Numpy和CatBoost：

  pip uninstall -y numpy catboost
  

• 清理pip缓存，避免安装缓存的旧包：

  pip cache purge
  

• 安装经过验证的兼容版本组合（推荐Numpy 1.26.x，与CatBoost兼容性稳定）：

  pip install numpy==1.26.4 catboost
  

2. 使用虚拟环境隔离依赖（关键步骤） #

如果全局环境存在依赖冲突，创建独立虚拟环境：

• 创建虚拟环境：

  python -m venv catboost_env
  

• 激活虚拟环境：

  # Windows系统
  catboost_env\Scripts\activate
  # Linux/macOS系统
  source catboost_env/bin/activate
  

• 在激活的虚拟环境中执行上述卸载、安装步骤。

3. 从源码编译CatBoost（终极方案） #

若预编译包仍不兼容，直接从源码编译适配当前环境：

pip install numpy==1.26.4
pip install --no-binary :all: catboost

验证安装 #

执行以下代码确认依赖版本正确：

import numpy
import catboost
print(f"Numpy版本: {numpy.__version__}")
print(f"CatBoost版本: {catboost.__version__}")

内容的提问来源于stack exchange，提问作者Emrah Yılmaz