版權(quán)聲明：本文為博主原創(chuàng)文章，如需轉(zhuǎn)載請貼上原博文鏈接：基于AI的量化投資框架Qlib的Python依賴包pyqlib安裝問題記錄-CSDN博客

---

前言：最近想使用Qlib來做量化交易的策略研究，但是第一步就卡在了安裝pyqlib依賴包，故記錄以自查避坑；附錄給出詳細(xì)的安裝需求依賴以及pyqlib的詳細(xì)依賴樹（圖片很長，流量警告！）。

---

目錄

一、環(huán)境準(zhǔn)備

二、pip安裝

2.1 安裝pyqlib所需的依賴

2.2 pyproject.toml報錯

附錄1：pyqlib安裝過程中的需求依賴

附錄2：pyqlib的依賴樹

---

一、環(huán)境準(zhǔn)備

1.1 電腦版本：Microsoft Windows 10 專業(yè)版，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）：

二、pip安裝

? ? ? ? 在使用pip安裝之前，曾嘗試使用conda安裝，但是Anaconda庫里面沒有pyqlib的依賴包，所以只能使用pip安裝。qlib官方給出的安裝方式有兩種：①pip安裝（如圖2.1 pyqlib==0.9.5支持的環(huán)境和py版本【截至目前20241023最新的版本】），②使用源代碼安裝（適用于安裝處在開發(fā)中的最新版本），以下只針對使用pip的安裝方式進(jìn)行記錄。

2.1 安裝pyqlib所需的依賴

? ? ? ? 在開始安裝之前先查看下pyqlib==0.9.5版本的所需依賴（如圖2.2），文章最后給出具體依賴包版本截圖（見附錄）。

? ? ? ? 一般直接使用pip安裝可能會出現(xiàn)下載鏈接超時，有兩種方式避免，如下：

# 法一：使用清華鏡像源（推薦）
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文件安裝的時候出現(xiàn)一些非pip的安裝問題。

2.2 pyproject.toml報錯

? ? ? ? 在整個安裝過程中，除了pip鏈接超時等問題之外，還遇到pyproject.toml報錯，這是因為在安裝pyqlib包的時候，它的依賴包里面的其他關(guān)聯(lián)依賴包出現(xiàn)問題，如圖2.3所示，此時我們選擇下載出問題的依賴包進(jìn)行手動安裝即可。

? ? ? ? 在手動安裝的過程中，發(fā)現(xiàn)這個報錯的原因是：通過pip安裝pyqlib依賴的時候往往是查找對應(yīng)環(huán)境的最新版本，例如上圖中的scs包，下載的是scs-3.2.7，而在pypi庫中找到該版本不支持py3.7，而scs最后一個支持py3.7的版本是scs3.2.4，所以文章開頭更加推薦python的環(huán)境版本升級到py3.8。

? ? ? ? 最后，看似該包安裝較簡單，但是也花費了兩到三天，主要是出現(xiàn)了“pyproject.toml”問題花費了一些時間，途中還查找了一些“pyproject.toml-based projects”相關(guān)的解決方法，也安裝了Microsoft C++生成工具，但實際上和這個無關(guān)，而是因為py環(huán)境對依賴包的版本不支持所造成的。

附錄1：pyqlib安裝過程中的需求依賴

附錄2：pyqlib的依賴樹