EasyXT 安装教程:5分钟搞定量化交易回测框架

EasyXT项目介绍

EasyXT是基于miniqmt中xtquant的二次开发封装库，旨在简化xtquant的使用，提供更友好的API接口。通过统一的接口设计、智能参数处理和完善的错误处理，让量化交易开发变得更加简单高效。

项目地址: https://github.com/quant-king299/EasyXT

🛠️ 环境准备

系统要求

• 操作系统：Windows 10/11（PowerShell 7）
• Python：3.9+（建议 3.10+），并将 Python 加入 PATH

ptrade/QMT账号获取指导

📱 还没有ptrade/QMT账号的朋友，可以扫码加我微信，全程指导搞定Ptrade/QMT账号！

告别复杂配置，一键安装，轻松开启量化交易之旅

📚 什么是 EasyXT？

EasyXT 是一个轻量级 QMT 量化交易框架，专门为个人投资者和量化交易者设计。它提供了：

• ✅ 简单易用的 API：几行代码即可获取股票数据
• ✅ 强大的回测引擎：支持多种策略回测
• ✅ 本地数据管理：DuckDB 存储，快速查询
• ✅ 完全开源免费：MIT 协议，可自由使用

🎯 为什么选择 EasyXT？

对比其他量化框架

一句话总结：EasyXT 是最适合个人投资者的本地量化交易工具！

🔧 快速安装（推荐）

⚡ 3 分钟完成安装

第一步：安装 easy_xt（核心库）

# 克隆项目git clone https://github.com/quant-king299/EasyXT.gitcd EasyXT# 安装核心库pip install -e easy_xt

第二步：安装 easyxt_backtest（回测框架）

# 进入回测框架目录cd easyxt_backtest# 运行自动安装脚本install.bat

第三步：验证安装

# 测试 easy_xtfrom easy_xt import get_apiprint("✅ easy_xt 安装成功！")# 测试 easyxt_backtestfrom easyxt_backtest import BacktestEngineprint("✅ easyxt_backtest 安装成功！")

就这么简单！ 🎉

💡 核心功能演示

1️⃣ 获取股票数据

from easy_xt import get_api# 初始化 APIapi = get_api()# 获取平安银行数据data = api.get_price(    ['000001.SZ'],    start='20240101',    period='1d')print(data.head())

2️⃣ 运行策略回测

from easyxt_backtest import BacktestEngine, DataManagerfrom easyxt_backtest.strategies import SmallCapStrategy# 创建回测引擎data_manager = DataManager()engine = BacktestEngine(    initial_cash=1000000,  # 100万初始资金    data_manager=data_manager)# 创建小市值策略strategy = SmallCapStrategy(select_num=3)# 运行回测result = engine.run_backtest(    strategy,'20230101','20231231')# 查看结果result.print_summary()result.plot_equity_curve()

3️⃣ 可视化界面

EasyXT 还提供了 图形化数据管理工具：

• 📊 数据查看器：查看本地存储的股票数据
• 📥 数据下载器：批量下载历史数据
• 📈 数据导出：导出为 CSV/Excel 格式

# 启动 GUIpython gui_app/main.py

❓ 常见问题解答

Q1: 安装时报错 No module named 'easy_xt'

原因：Python 环境未刷新

解决方案：

# 方法1：重启 PowerShell# 关闭当前窗口，重新打开# 方法2：验证安装pip list | findstr easy# 应该看到：easy-xt# 方法3：重新安装pip uninstall easy-xt -ypip install -e ./easy_xt

Q2: 安装时报错 No module named 'backtrader'

原因：缺少 backtrader 依赖

解决方案：

pip install backtrader

Q3: ModuleNotFoundError: No module named 'easyxt_backtest.core.backtest_core'

原因：项目文件不完整

解决方案：

# 拉取最新代码git pull origin main# 检查文件是否存在dir easyxt_backtest\core\backtest_core.py

Q4: 配置 PYTHONPATH 后仍然无法导入

原因：环境变量未生效

解决方案：

# 1. 检查 PYTHONPATHecho $env:PYTHONPATH# 应该输出：D:\EasyXT# 2. 重启终端（重要！）# 配置 PYTHONPATH 后必须重启才能生效# 3. 验证python -c "import sys; print(sys.path[0])"

Q5: git pull 失败

错误信息：

error: Your local changes would be overwritten

解决方案：

# 暂存本地修改git stash push -m "保存配置" xtquant/# 拉取最新代码git pull origin main# 恢复修改git stash pop

🎓 进阶使用技巧

技巧1：使用虚拟环境（推荐）

# 创建虚拟环境python -m venv venv# 激活虚拟环境.\venv\Scripts\Activate.ps1# 安装 EasyXTpip install -e ./easy_xt

优点：

• ✅ 隔离项目依赖
• ✅ 避免版本冲突
• ✅ 易于管理

技巧2：配置 VSCode 开发环境

1. 设置 Python 解释器

• 按 Ctrl+Shift+P
• 输入 "Python: Select Interpreter"
• 选择虚拟环境的 Python

2. 配置环境变量

   {"env":{"PYTHONPATH":"${workspaceFolder}"}}

• 创建 .vscode/launch.json：

技巧3：自定义策略开发

from easyxt_backtest.strategies import BaseStrategyclassMyStrategy(BaseStrategy):"""    自定义策略示例    """def__init__(self, select_num=10):super().__init__()self.select_num = select_numdefselect_stocks(self, date):"""        选股逻辑        """# 获取所有股票        all_stocks = self.data_manager.get_all_stock_list()# 这里添加你的选股逻辑# 例如：选择市值最小的股票# ...return selected_stocks# 运行自定义策略strategy = MyStrategy(select_num=5)result = engine.run_backtest(strategy, '20230101', '20231231')

📊 安装方式对比

🎉 总结

EasyXT 的三大优势：

1. 安装简单
   ：5 分钟完成，一键配置
2. 功能强大
   ：数据获取 + 策略回测 + 可视化管理
3. 完全免费
   ：开源项目，可自由使用和修改

现在就安装 EasyXT，开启你的量化交易之旅吧！ 🚀

git clone https://github.com/quant-king299/EasyXT.gitcd EasyXTpip install -e easy_xtcd easyxt_backtestinstall.bat

祝你安装顺利！ 🎊

📱 关注我们

欢迎扫码持续关注公众号，会持续分享

🔍 公众号名称: 王者quant📚 分享内容: 量化交易、Python编程、投资策略🎯 更新频率: 持续更新，干货满满

通过公众号您可以获得：

• 📈 最新的量化交易策略分享
• 💻 Python量化编程技巧
• 📊 市场分析和投资心得
• 🚀 EasyXT功能更新和使用技巧
• 💡 量化交易实战案例

本教程仅供学习参考，实际交易请谨慎操作！