Windows安装PyCaret报错：缺失numpy.distutils._msvccompiler模块

一、即时报错修复步骤 #

1. 修复numpy.distutils._msvccompiler缺失问题 #

Python 3.10与numpy 1.24+版本的distutils模块存在兼容性变动，导致该模块缺失。执行以下命令回退到适配版本：

pip uninstall -y numpy
pip install numpy==1.23.5

2. 解决BLAS/LAPACK查找失败问题 #

Windows下手动编译科学计算库容易出错，优先使用预编译二进制包：

• 若使用conda（推荐）：

  conda install -c conda-forge blas lapack scipy
  

• 若仅使用pip：

  pip install scipy==1.9.3 --only-binary :all:
  

3. 安装兼容版本的PyCaret #

针对Python 3.10，选择PyCaret 3.0.2这个经过验证的稳定版本，若安装仍有问题，添加--no-build-isolation参数跳过编译隔离：

pip install pycaret==3.0.2
# 若出现编译相关错误，执行：
pip install pycaret==3.0.2 --no-build-isolation

二、长期版本管理最佳方案 #

1. Conda环境隔离（推荐） #

Conda能自动处理所有依赖的版本适配和预编译包，彻底解决部署问题：

• 创建专属环境并激活：

  conda create -n pycaret_env python=3.10.8 -y
  conda activate pycaret_env
  

• 安装PyCaret（自动拉取所有兼容依赖）：

  conda install -c conda-forge pycaret=3.0.2 -y
  

• 导出环境配置，新系统一键部署：

  conda env export > pycaret_env.yml
  # 新系统导入：
  conda env create -f pycaret_env.yml -y
  

2. Pipenv/Poetry纯Python依赖管理 #

若不想使用conda，用Pipenv锁定依赖版本：

• 安装Pipenv：

  pip install pipenv
  

• 创建指定Python版本的项目环境：

  pipenv --python 3.10.8
  

• 安装PyCaret并锁定所有依赖：

  pipenv install pycaret==3.0.2
  # 新系统部署时，复制Pipfile和Pipfile.lock后执行：
  pipenv install
  

核心注意事项 #

• 固定版本：所有安装命令必须指定具体版本号，禁止使用无版本的pip install pycaret，避免自动升级到不兼容版本。
• 预编译优先：始终选择预编译二进制包，避免在Windows下编译C扩展库，减少报错概率。

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