基于AI的量化投资框架Qlib的Python依赖包pyqlib安装问题记录

版权声明：本文为博主原创文章，如需转载请贴上原博文链接：基于AI的量化投资框架Qlib的Python依赖包pyqlib安装问题记录-CSDN博客

---

前言：最近想使用Qlib来做量化交易的策略研究，但是第一步就卡在了安装pyqlib依赖包，故记录以自查避坑；附录给出详细的安装需求依赖以及pyqlib的详细依赖树（图片很长，流量警告！）。

---

目录

一、环境准备

二、pip安装

2.1 安装pyqlib所需的依赖

2.2 pyproject.toml报错

附录1：pyqlib安装过程中的需求依赖

附录2：pyqlib的依赖树

---

一、环境准备

1.1 电脑版本：Microsoft Windows 10 专业版，x64-based PC

1.2 python版本：Python 3.7.4

Tips：适用于pyqlib的python版本如下图，官方建议至少将python版本升级到py3.7，而py3.9会有部分功能不支持，故建议的python版本为py3.7或py3.8（更推荐py3.8）：

图1 适用于pyqlib的python版本

二、pip安装

        在使用pip安装之前，曾尝试使用conda安装，但是Anaconda库里面没有pyqlib的依赖包，所以只能使用pip安装。qlib官方给出的安装方式有两种：①pip安装（如图2.1 pyqlib==0.9.5支持的环境和py版本【截至目前20241023最新的版本】），②使用源代码安装（适用于安装处在开发中的最新版本），以下只针对使用pip的安装方式进行记录。

图2.1 pyqlib==0.9.5支持的环境和py版本

2.1 安装pyqlib所需的依赖

        在开始安装之前先查看下pyqlib==0.9.5版本的所需依赖（如图2.2），文章最后给出具体依赖包版本截图（见附录）。

图2.2 安装pyqlib所需的依赖

        一般直接使用pip安装可能会出现下载链接超时，有两种方式避免，如下：

# 法一：使用清华镜像源（推荐）
pip install pyqlib -i https://pypi.tuna.tsinghua.edu.cn/simple/# 法二：下载whl文件后再pip安装：https://pypi.org/project/pyqlib/0.9.5/#files
pip install pyqlib-0.9.5-cp37-cp37m-win_amd64.whl --user

一般能够顺利安装，但是我在使用whl文件安装的时候出现一些非pip的安装问题。

2.2 pyproject.toml报错

        在整个安装过程中，除了pip链接超时等问题之外，还遇到pyproject.toml报错，这是因为在安装pyqlib包的时候，它的依赖包里面的其他关联依赖包出现问题，如图2.3所示，此时我们选择下载出问题的依赖包进行手动安装即可。

图2.3 pyproject.toml报错

        在手动安装的过程中，发现这个报错的原因是：通过pip安装pyqlib依赖的时候往往是查找对应环境的最新版本，例如上图中的scs包，下载的是scs-3.2.7，而在pypi库中找到该版本不支持py3.7，而scs最后一个支持py3.7的版本是scs3.2.4，所以文章开头更加推荐python的环境版本升级到py3.8。

        最后，看似该包安装较简单，但是也花费了两到三天，主要是出现了“pyproject.toml”问题花费了一些时间，途中还查找了一些“pyproject.toml-based projects”相关的解决方法，也安装了Microsoft C++生成工具，但实际上和这个无关，而是因为py环境对依赖包的版本不支持所造成的。

附录1：pyqlib安装过程中的需求依赖

附录2：pyqlib的依赖树