Qlib / First Run

Qlib 首次运行：用 qrun 跑通第一个量化工作流

装好 Qlib 后，最快验证方式是用官方 Quick Start 的 qrun 命令跑一个 LightGBM 示例工作流，它会完成数据集构建、模型训练、回测与评估，输出风险与收益指标。

工具：qrun示例：LightGBM Alpha158输出：回测报告与指标

qrun 命令运行 LightGBM Alpha158 工作流

回测报告风险 · 收益 · 年化 · 信息比率 · 最大回撤

Qlib 首次运行 qrun 工作流示意图（命令→回测报告），基于官方示例。

Steps

首次运行四步

以下步骤来自 Qlib 官方 Quick Start。

按安装页完成 pip / 源码 / Docker 安装。

下载或采集 qlib 格式数据到本地目录。

进入 examples 目录执行 qrun 命令（见下方）。

读取回测与评估指标，理解策略表现。

Command

cd examples   # 避免在包含 qlib 的目录下运行
qrun benchmarks/LightGBM/workflow_config_lightgbm_Alpha158.yaml

说明：该命令会运行完整工作流：构建数据集 → 训练 LightGBM 模型 → 回测 → 评估。命令来自官方 README Quick Start（2026-08 核验）。

Report

qrun 输出的核心指标（官方说明）。

组合风险度量，用于衡量策略波动性。

策略在回测期的平均收益。

折算到年度的收益表现。

历史峰谷最大跌幅，衡量风险。

风险提示：以上指标仅代表回测期历史表现，涉及数据、参数与市场环境假设，不构成收益保证或投资建议。