安装PyCaret库失败 提示scikit-learn构建wheel报错

报错信息 #

安装PyCaret过程中scikit-learn依赖构建失败，更新pip无法解决，核心报错输出：

error: could not create 'build\bdist.win-amd64\wheel\.\sklearn\datasets\tests\data\openml\292\api-v1-json-data-list-data_name-australian-limit-2-data_version-1-status-deactivated.json.gz': No such file or directory
  [end of output]note: This error originates from a subprocess, and is likely not a problem with pip. ERROR: Failed building wheel for scikit-learn Failed to build scikit-learn

ERROR: Could not build wheels for scikit-learn, which is required to install pyproject.toml-based projects

故障原因 #

• 该问题由Windows系统默认的260字符路径长度限制导致：scikit-learn本地编译构建时生成的测试文件路径过长，超出系统路径长度上限后无法创建对应文件，最终触发wheel构建失败。
• 出现该问题通常是因为pip未匹配到对应环境的scikit-learn预编译包，自动拉取源码在本地编译触发路径问题。

解决步骤 #

按优先级从高到低尝试以下方案：

• 优先安装预编译版scikit-learn跳过本地编译
  执行命令强制安装二进制版本的scikit-learn，避免源码编译过程：
  pip install scikit-learn --only-binary :all:
  等待scikit-learn安装完成后，再执行pip install pycaret完成剩余依赖安装即可。
• 解除Windows长路径限制
  按Win+R组合键输入gpedit.msc打开本地组策略编辑器，依次进入「计算机配置 > 管理模板 > 系统 > 文件系统」目录，找到「启用Win32长路径」项，将其设置为已启用，保存设置后重启电脑，重新执行PyCaret安装命令即可。
• 缩短安装执行路径
  若无法修改系统设置，可直接在磁盘根目录下创建短名称文件夹（例如C:\p），在该文件夹路径下打开终端执行安装命令，通过缩短构建时的基础路径长度避开260字符限制。

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