vnpy操作手册

一、vn.py 是什么（开源事件驱动框架 + CTP）

vn.py（读作 "venopy"，现品牌名 VeighNa，马的意思）是国内用户量最大、最活跃的开源量化交易框架，由国人原创。它的定位是事件驱动的本地程序化交易系统框架：不是给你一个写好策略的软件，而是给你一整套"交易接口 + 策略引擎 + 风控 + 图表"的积木，让你拼出自己的自动交易系统。

• 全免费开源（核心 MIT 协议，随便用、可审计源码、无后门顾虑）；
• Python 写策略，能直接接 pandas / 机器学习生态；
• 国内期货（CTP）、股票（XTP/TORA/OES）、ETF 期权、外盘（IB）、加密货币（OKX/Binance/BitMEX）等多市场；
• 专业个人、创业型私募、券商资管都在用；中文文档与社区活跃。

它和文华 WH8 的本质区别：

新手注解：如果你不会 Python，别碰 vn.py。先用文华 WH8 的麦语言入门，等你会写类、看得懂报错了再来。vn.py 是"给程序员的交易系统积木"，不是开箱即用的点单软件。

1、社区版与商业版（2026 年现状）

vn.py 生态现在分两条线：

二、安装与启动（VeighNa Station / run.py）

1、环境准备

• Python 3.10 / 3.11（vn.py 官方推荐；别用 3.12+/3.8 以下，网关 dll 适配容易出问题）；
• Windows 为主（CTP 等柜台接口是 Windows DLL；部分接口在 Ubuntu 上也支持）；
• 建议用 Anaconda 管理虚拟环境。

2、方式一：pip 安装核心 + 网关

conda create -n vnpy python=3.10
conda activate vnpy

pip install vnpy # 安装核心框架
pip install vnpy_ctp # 国内期货 CTP 网关
pip install vnpy_sqlite # SQLite 数据库（默认本地存储）

3、方式二：用 run.py 启动（可自由拼装模块）

克隆源码后进入 examples/veighna_trader/run.py，里面用 add_gateway() / add_app() 决定加载哪些接口和模块（大量项默认注释掉，按需取消注释）：

from vnpy_ctp import CtpGateway
from vnpy_ctastrategy import CtaStrategyApp
from vnpy_ctabacktester import CtaBacktesterApp
from vnpy_datamanager import DataManagerApp

def main():
    qapp = create_qapp()
    event_engine = EventEngine()
    main_engine = MainEngine(event_engine)
main_engine.add_gateway(CtpGateway) # 加载 CTP 接口
main_engine.add_app(CtaStrategyApp) # CTA 策略
main_engine.add_app(CtaBacktesterApp) # 图形化回测
    main_window = MainWindow(main_engine, event_engine)
    main_window.showMaximized()
    qapp.exec()

在该目录按住 Shift + 右键 →"在此处打开 PowerShell"，运行 python run.py 即可启动图形界面。

4、方式三：VeighNa Station 启动器（官方推荐新手）

装好后命令行输入 veighna（或双击桌面 VeighNa Station 图标）启动 Station → 首次登录确认免责声明 → 点【交易】按钮 → 在配置对话框里勾选要用的交易接口和应用模块 → 点【启动】进入 VeighNa Trader。

白话：run.py 是"自己手写清单点菜"，VeighNa Station 是"菜单上打勾点菜"。新手用 Station 勾选即可；进阶玩家改 run.py 精确控制加载哪些模块、用哪个数据库。

三、核心架构（事件驱动 / MainEngine / Gateway / App）

┌─────────────────────────────────────┐
│ MainEngine（主引擎，一切入口） │
│ 内部挂 EventEngine（事件引擎） │
├─────────────────────────────────────┤
│ 应用模块 vnpy.app： │
│ CtaStrategy / CtaBacktester / │
│ DataManager / DataRecorder / │
│ RiskManager / AlgoTrading / ... │
├─────────────────────────────────────┤
│ 交易接口 Gateway： │
│ CtpGateway / XtpGateway / │
│ IbGateway / OkxGateway / ... │
└─────────────────────────────────────┘

新手注解：vn.py 是事件驱动架构——不是你写个 while 循环去查行情，而是柜台每推来一笔 tick，EventEngine 就发一个"tick 事件"，订阅了的策略被动响应。这种写法延迟低、好扩展，是专业交易系统的标准做法。

四、VeighNa Trader 图形界面与配置

1、界面主结构

VeighNa Trader 是基于 PyQt 的桌面窗口：顶部是菜单栏（系统、帮助等），左侧是各类功能面板（CTA 策略、数据管理、风控等），主区域显示日志、持仓、委托、成交等表格。

2、连接接口入口

菜单栏【系统】→【连接 CTP】（或对应接口名）→ 弹出账号配置窗口 → 填账号密码服务器 → 连接。连接成功后在日志区看到查询账号、持仓、委托、成交的回报。

3、配置文件存在哪

各接口的账号配置保存在用户目录下的 .vntrader 文件夹里（JSON 文件）。好处是：升级 vn.py 不会丢配置。你既可以在图形界面里改，也可以直接去 ~/.vntrader/ 改对应 JSON。

4、查询可交易合约

先登录接口，再点菜单【帮助】→【查询合约】→ 弹出窗口留空点【查询】即列出全部可交易合约（可按合约代码过滤）。新用户对着列表抄 vt_symbol（如 rb2501.SHFE）最稳。

白话：.vntrader 文件夹是 vn.py 的"家目录"——配置、日志、数据库默认都在这。换电脑时把它整个拷走，配置就跟着走了。

五、应用模块（vnpy.app）全览

vn.py 不只有 CTA 策略。官方开箱即用的应用模块：

白话：新手别贪多。先把 cta_strategy + cta_backtester + data_manager 三个跑通就够；等做套利再碰 spread_trading，做大单拆单再碰 algo_trading。risk_manager 强烈建议实盘前就开——它是你手动下单手滑时的最后一道闸。