VeighNa Windows 安装全指南VeighNa Studio 一键方案与手动源码安装详解【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/gh_mirrors/vn/vnpyVeighNavnpy是一套基于 Python 的开源量化交易系统开发框架。本文聚焦其在Windows 平台上的完整安装流程覆盖官方推荐的VeighNa Studio Python 发行版方案适合新手与手动源码安装方案适合有经验的开发者或需要 Anaconda 等特定 Python 发行版的用户。读完本文你将掌握从环境准备、一键安装、环境验证到启动 VeighNa Trader 图形化交易终端的全部实操方法并能根据自身需求裁剪启动脚本中的交易接口与应用模块。一、安装方案总览与适用场景本文档中安装步骤适用的 Windows 系统包括Windows 10 / 11Windows Server 2019其他版本的 Windows 系统安装时可能遇到各种依赖库问题官方不推荐使用。另需注意README.md 中的环境准备说明已更新为Windows 11 以上 / Windows Server 2022 以上实际使用时以你的系统版本与当前安装包要求为准。在 Windows 上安装 VeighNa 有两条主流路径选择依据主要是编程经验方案适合人群特点VeighNa Studio初次接触 Python 的编程新手一站式环境Python、VeighNa 及依赖库、VeighNa Station 全部整合图形化安装与升级手动安装已有丰富编程经验或需使用特定 Python 发行版如 Anaconda、Miniconda基于系统 Python 环境通过install.bat一键安装灵活可控二、方案一VeighNa Studio官方推荐VeighNa Studio 是官方推出的一站式量化投研交易 Python 环境它整合了三部分内容Python 3.10 64 位Python 官网版本VeighNa 框架本身及其他相关依赖库VeighNa StationVeighNa 框架的图形化管理工具因此安装完成后无需再单独配置 Python 与依赖开箱即用。2.1 下载与安装在 VeighNa 官网可以下载 VeighNa Studio 安装包对应仓库 vnpy/init.py 中版本号所示发行版。下载完成后双击安装包进入 VeighNa Studio 安装向导推荐点击右键选择【使用管理员身份运行】进行安装。使用默认设置点击【快速安装】按钮即可完成安装。推荐将 VeighNa Studio 安装在默认路径C:\veighna_studioVeighNa 官方其他文档和教程均使用该目录作为安装目录进行讲解保持默认路径可以避免后续教程中路径不一致的问题。如果想进行个性化安装可点击【自定义安装】进入高级选项页面按需选择需要安装的功能组件后再继续。安装完成后会转换到安装成功页面此时桌面会出现 VeighNa Station 的图标双击图标即可运行 VeighNa Station。2.2 使用验证环境是否可用安装成功后启动命令行工具即可直接使用 VeighNa Studio 自带的 Python 发行版。第一步验证 Python 环境在命令行CMD 或 PowerShell中输入python即可进入 Python 的交互式环境此时输入 Python 代码会立即执行。第二步运行 pyqtgraph 自带示例VeighNa 的图形界面基于 PySide6 与 pyqtgraph 构建见 pyproject.toml 依赖声明。可以运行 pyqtgraph 自带的例子验证图形库是否正常from pyqtgraph import examples examples.run()此时会弹出 Examples 运行窗口点击左侧的Basic Plotting即可弹出示例图形界面。第三步启动 Jupyter Lab 进行投研打开 cmd输入jupyter lab即可成功启动 Jupyter Lab。这是进行量化投资研究数据下载、因子分析、策略回测等的常用工作台仓库的 examples/alpha_research 目录下即提供了基于 Notebook 的量化投研工作流示例。2.3 修改安装内容如果安装之后想要添加或移除某项功能可以双击 VeighNa Studio 的安装包进入安装界面后点击【修改】。在修改页面中勾选或取消需要的可选功能点击【下一步】进入高级选项页面选择完毕后即可重新安装。2.4 修复安装如果安装之后出现安装不完整或其他需要修复的情况同样双击安装包进入安装界面点击【修复】进入修复界面。修复完成后会转换到修复成功页面。2.5 卸载如果想卸载 VeighNa Studio双击安装包进入安装界面点击【卸载】进入卸载界面卸载完成后会转换到卸载成功页面。如需彻底清理建议卸载后手动删除C:\veighna_studio目录如有残留数据。三、方案二手动安装3.1 准备 Python 环境首先请在电脑上准备好Python 3.10 64 位环境注意必须是 64 位版本推荐使用 Python 官网的发行版也可以使用 Anaconda、Miniconda、Canopy 等发行版。以 Python 官网发行版为例的安装步骤在 Python 官网下载安装文件选择【Windows installer (64-bit)】下载完毕后双击文件进入 Python 安装向导勾选【Add Python3.10 to PATH】选项后点击【Install Now】进行安装推荐使用默认设置一路点击【下一步】直到安装完成。勾选 Add to PATH 非常重要它使python、pip命令在任意命令行目录下可直接调用这是后续install.bat脚本能够直接找到python的前提。仓库 pyproject.toml 中声明requires-python 3.10同时分类器列出的受支持 Python 版本为 3.10、3.11、3.12、3.13。从源码结构看当前版本的 VeighNa 核心框架已兼容更新的 Python 版本但官方安装文档以 Python 3.10 64 位为基准编写手动安装时优先以 3.10 64 位为准可最大程度降低依赖兼容问题。3.2 下载 VeighNa 源代码下载 VeighNa 源代码Windows 系统请选择 zip 格式的 Release 发布版本VeighNa GitHub Releases 页面VeighNa Gitee 镜像 Releases 页面下载完成后解压到本地目录。注意后续所有命令都需要在解压后的源代码目录即install.bat文件所在的目录中执行。3.3 一键安装install.bat启动命令行工具CMD 或者 PowerShell进入源代码所在的目录后输入下列命令运行脚本执行一键安装install.bat一键安装过程整体分为 2 步下载安装 ta-lib 库TA-Lib技术指标计算库VeighNa 的策略回测与指标计算依赖它安装 VeighNa 本身。install.bat的实际内容可以从仓库根目录的 install.bat 文件中直接查看其核心逻辑为ECHO OFF SET python%1 SET pypi_index%2 IF %python% SET pythonpython IF %pypi_index% SET pypi_indexhttps://pypi.vnpy.com IF NOT %pypi_index% SET pypi_index--index-url %pypi_index% ECHO ON :: Upgrade pip wheel %python% -m pip install --upgrade pip wheel %pypi_index% ::Install prebuild wheel %python% -m pip install --extra-index-url https://pypi.vnpy.com ta_lib0.6.4 :: Install VeighNa %python% -m pip install .对脚本做逐段解析参数支持脚本接受两个可选参数——%1为 Python 解释器命令默认python%2为 PyPI 索引地址默认https://pypi.vnpy.com即 VeighNa 官方 PyPI 镜像可显著加速国内下载。第 1 步升级工具pip install --upgrade pip wheel保证 pip 与 wheel 打包工具为最新版本。第 2 步安装 TA-Lib 预编译包pip install --extra-index-url https://pypi.vnpy.com ta_lib0.6.4。TA-Lib 是典型的 C 扩展库在 Windows 上源码编译极易失败因此官方通过--extra-index-url从pypi.vnpy.com拉取ta_lib 0.6.4 的预编译 wheel这也是为什么 Windows 手动安装能一键完成的核心原因。第 3 步安装 VeighNapip install .在当前目录执行pip 会根据 pyproject.toml 自动解析并安装全部依赖包括PySide66.8.2.1图形界面、pyqtgraphK 线图表、numpy、pandas、deap遗传算法参数优化、pyzmqRPC 通讯、loguru日志等核心库。如果某一步安装过程中发生错误请截取保存命令行中的报错信息注意优先保存底部的报错内容前往 VeighNa 社区论坛发帖提问寻求帮助——底部报错通常才是真正的根因顶部大段堆栈往往是连锁反应。3.4 启动 VeighNa Trader安装完成后即可启动 VeighNa Trader图形化交易终端。启动命令行工具进入解压 VeighNa 源代码的目录下在文件夹examples/veighna_trader中找到run.py文件输入如下命令python run.py即可启动 VeighNa Trader。关于 run.py 的说明务必阅读run.py中包含了较多的启动加载项交易接口和应用模块请根据自己所用的操作系统以及实际的交易需求修改调整使用。若需加载接口或模块取消对应代码前的注释符号即可。从仓库 examples/veighna_trader/run.py 可以看到其默认结构from vnpy.event import EventEngine from vnpy.trader.engine import MainEngine from vnpy.trader.ui import MainWindow, create_qapp from vnpy_ctp import CtpGateway # from vnpy_ctptest import CtptestGateway # from vnpy_mini import MiniGateway # from vnpy_femas import FemasGateway # from vnpy_sopt import SoptGateway # ... from vnpy_ctastrategy import CtaStrategyApp from vnpy_ctabacktester import CtaBacktesterApp # from vnpy_spreadtrading import SpreadTradingApp # from vnpy_algotrading import AlgoTradingApp # ... from vnpy_datamanager import DataManagerApp def main(): qapp create_qapp() event_engine EventEngine() main_engine MainEngine(event_engine) main_engine.add_gateway(CtpGateway) # main_engine.add_gateway(CtptestGateway) # ... main_engine.add_app(CtaStrategyApp) main_engine.add_app(CtaBacktesterApp) # ... main_engine.add_app(DataManagerApp) main_window MainWindow(main_engine, event_engine) main_window.showMaximized() qapp.exec() if __name__ __main__: main()默认情况下脚本加载了CTP 交易接口CtpGateway国内期货、期权、CTA 策略模块CtaStrategyApp、CTA 回测模块CtaBacktesterApp和历史数据管理模块DataManagerApp。需要接入其他接口如 CTP Mini、飞马、易盛、中泰 XTP、华鑫奇点、海外 IB 等或加载其他应用如价差交易、算法交易、期权交易、脚本交易、组合策略、行情录制、风控管理等时取消对应 import 与add_gateway/add_app行的注释即可。注意加载接口前需确保对应的vnpy_xxx扩展包已通过 pip 单独安装它们以独立仓库形式发布不属于 vnpy 核心包。如果启动时出现一些库版本不兼容的情况可根据提示对这些库重新 pip 安装。连接交易接口的具体操作详见文档中心交易接口相关篇章。四、进阶VeighNa Station 图形化管理若使用 VeighNa Studio 方案安装完成后桌面会出现 VeighNa Station 图标手动安装方案下也可以单独安装使用 VeighNa Station 管理工具。其完整使用说明见 docs/community/info/veighna_station.md这里提炼与安装直接相关的关键点启动与登录双击桌面图标或命令行输入veighna即可启动首次运行需登录VeighNa 社区论坛账号密码即是新用户可点击【注册】。交易启动点击左侧【交易】按钮勾选需要加载的交易接口和应用模块点击左下角【启动】按钮即可启动 VeighNa Trader右侧输出区域会实时显示运行日志。通过 VeighNa Trader 运行过程中请勿关闭 VeighNa Station会自动退出。投研环境点击【投研】按钮可一键启动 JupyterLab 应用。策略加密点击【加密】按钮可将选定的.py策略文件编译为.pyd文件加密后需先把 pyd 文件名中的.cp310-win_amd64部分移除再放入自建strategies文件夹中。组件更新点击【更新】按钮可检查本地已安装模块及版本并一键更新。五、进阶无界面脚本启动方式对于部署在服务器或需要无人值守运行的场景可以绕开图形界面使用脚本方式直接驱动交易引擎。仓库 examples/no_ui/run.py 提供了一个完整的无界面 CTA 策略守护进程示例父进程按国内期货日盘/夜盘交易时段日盘 8:45–15:00、夜盘 20:45–次日 2:45自动拉起/关闭子进程子进程中创建MainEngine、加载 CTP 网关与 CTA 策略引擎、连接行情与交易服务器并自动初始化、启动全部策略。该脚本同时演示了通过 vnpy/trader/setting.py 中的SETTINGS字典进行全局配置的方式如SETTINGS[log.active]、SETTINGS[log.level]、SETTINGS[log.console]实际项目中还支持通过运行目录下的vt_setting.json文件覆盖数据库、数据服务、邮件告警等配置项。手动安装用户完成上述安装后也可以仿照该脚本构建自己的无人值守交易程序。六、安装后的常见问题与排错python命令找不到多为手动安装时未勾选【Add Python3.10 to PATH】可重新运行 Python 安装程序勾选该项或手动将 Python 安装目录加入系统环境变量 PATH。ta-lib 安装失败确认使用的是 64 位 Python若默认镜像拉取失败可手动指定官方镜像重试pip install --extra-index-url https://pypi.vnpy.com ta_lib0.6.4。启动 run.py 报库版本不兼容根据提示对相关库重新 pip 安装升级或降级到 pyproject.toml 中声明的最低版本以上。依赖下载缓慢可为 pip 配置国内镜像源或在运行install.bat时传入第二个参数指定索引地址。系统版本过旧Windows 7/8 等非文档支持版本可能出现各类依赖库问题官方不推荐使用。七、结语至此Windows 平台上的两种 VeighNa 安装路径已全部走通新手推荐 VeighNa Studio 一站式方案安装即得 Python 3.10 64 位 VeighNa 全量依赖 VeighNa Station 管理工具有经验的开发者则可基于系统 Python 手动安装借助 install.bat 的预编译 TA-Lib wheel 与 pip 自动依赖解析快速完成部署。安装完成后通过 examples/veighna_trader/run.py 启动 VeighNa Trader即可开始连接交易接口、配置数据服务进入量化策略开发与实盘交易阶段。【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/gh_mirrors/vn/vnpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考