VeighNa（vn.py）PyCharm 开发指南：环境配置、Trader 启动与 C++ 回调断点调试实战

VeighNavn.pyPyCharm 开发指南环境配置、Trader 启动与 C 回调断点调试实战【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/gh_mirrors/vn/vnpyPyCharm 是 JetBrains 推出的专业 Python IDE内置代码补全、静态检查、断点调试、包管理等一整套开发工具链。本文以当前仓库的开源量化交易框架 VeighNa 为核心完整讲解从 PyCharm 安装、绑定 VeighNa Studio 解释器、创建项目、浏览框架源码到启动 VeighNa Trader、编写策略回测脚本并执行断点调试的完整流程同时深入剖析 C 回调线程CTP 行情接口、PySide 图形库的断点调试方案。读者读完本文后即可在 PyCharm 中搭建一套可直接运行的 VeighNa 开发调试环境。本文内容基于 Windows 系统编写但对于 Linux/Mac 系统大部分也都适用。涉及的可运行脚本、回测示例与框架源码均位于当前仓库中可随时对照查阅。开发环境准备系统要求VeighNa 适用的 Windows 系统包括Windows 10/11Windows Server 2019/2022其他版本的 Windows 系统安装时可能遇到各种依赖库问题不推荐使用。安装 VeighNa Studio在 Windows 系统上使用 VeighNa推荐安装官方推出的【VeighNa Studio】Python 发行版尤其是初次接触 Python 开发的新手用户。作为一站式的量化投研交易 Python 环境VeighNa Studio 整合了Python 3.10 64 位Python 官网版本VeighNa 框架本身和其他相关依赖库VeighNa StationVeighNa 框架的图形化管理工具从官方渠道下载 VeighNa Studio 安装包后双击进入安装向导推荐使用默认设置点击【快速安装】即可完成安装安装目录建议保持默认的C:\veighna_studio其他 VeighNa 文档和教程中均使用该目录作为 VeighNa 安装目录进行讲解详见 Windows 安装指南。对于已有较丰富编程经验或需要特定 Python 发行版如 Anaconda的用户也可以采用手动安装方案准备好 Python 3.10 64 位环境注意必须是 64 位版本下载本仓库源码后在install.bat所在目录执行一键安装脚本再进入examples/veighna_trader目录用python run.py启动 VeighNa Trader。安装 PyCharm从 PyCharm 官网下载 PyCharm Community 安装包Community 社区版即可满足本文全部开发需求下载完成后双击安装包进入 PyCharm 安装向导在 PyCharm Community Edition Setup 页面按需勾选安装选项例如Create Desktop Shortcut创建桌面快捷方式、Add launcher dir to the PATH等一路按默认设置完成安装最终进入安装成功页面若前面勾选了创建桌面快捷方式桌面上会出现 PyCharm 图标双击即可运行。创建 VeighNa 开发项目新建项目并绑定解释器启动 PyCharm 后在弹出的欢迎界面中点击【New Project】创建新项目在弹出的新项目窗口中首先选择存放项目的文件夹路径【Location】勾选 Python 解释器选项中的【Previously configured interpreter】使用系统中已经安装的 Python 环境点击右侧 Add Interpreter 下拉框中的【Add Local Interpreter】在弹出的对话框左侧点击【System Interpreter】标签在右侧下拉框中选择 VeighNa Studio 自带 Python 解释器所在的路径即 VeighNa Studio 安装目录C:\veighna_studio下的 Python 可执行文件点击底部的【OK】按钮保存解释器配置回到新项目窗口后点击右下方的【Create】按钮完成创建。创建成功后PyCharm 即会以 VeighNa Studio 的 Python 3.10 环境作为项目解释器这意味着框架依赖如 PySide、pyqtgraph、pandas 等无需额外配置即可直接 import。浏览框架源码与模块包项目创建成功后点击左上方【External Libraries】即可看到项目中可以调用的外部库。展开 site_packages 文件夹往下滚动就能找到 VeighNa Studio 中的vnpy 核心框架包以及vnpy_ 前缀的插件模块包如 vnpy_ctp、vnpy_ctastrategy、vnpy_ctabacktester 等。通过点击对应包名可以查看每个包内的源码文件例如本仓库的 vnpy/trader/engine.py 定义了主引擎 MainEnginevnpy/trader/ui/init.py 导出了MainWindow与create_qapp等 UI 组件。在 PyCharm 中浏览这些源码时有两个高频技巧查看文档信息把鼠标光标移到代码上方会自动弹出对应代码的文档字符串docstring信息跳转到声明按住 Ctrl 键的同时用鼠标左键点击代码会跳转到该符号的声明部分类定义、函数签名、变量定义等。Python 包版本管理点击窗口右下角的【Python 3.10】按钮会弹出【Settings】项目配置窗口可以看到当前解释器环境下安装的包名称、本地版本号、最新版本号。带有升级符号向上箭头的包说明当前版本不是最新版点击升级符号即可自动升级。请注意由于 VeighNa 对于部分依赖库有严格的版本要求不建议用户手动升级安装的包到最新版否则可能出现版本冲突导致框架无法正常加载运行。运行 VeighNa Trader 程序准备启动脚本 run.py从本仓库获取 examples/veighna_trader/run.py 启动脚本文件将其放置于你的项目文件夹下或直接以本仓库为项目即可在窗口左侧的项目导航栏中看到 run.py 文件。该启动脚本的核心逻辑对应 run.py 中的main()函数如下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_gateway(MiniGateway) ... main_engine.add_app(CtaStrategyApp) main_engine.add_app(CtaBacktesterApp) # main_engine.add_app(SpreadTradingApp) ... main_window MainWindow(main_engine, event_engine) main_window.showMaximized() qapp.exec()脚本依次完成四件事创建 Qt 应用对象、创建事件引擎EventEngine与主引擎MainEngine、向主引擎注册交易接口Gateway和应用模块App、创建并最大化显示 VeighNa Trader 主窗口后进入 Qt 事件循环。run.py 中包含了较多启动加载项例如以#注释掉的CtptestGateway、MiniGateway、SpreadTradingApp、RiskManagerApp等接口与模块。请根据自己所用的操作系统以及实际的交易需求修改调整若需加载某个接口或模块取消对应行前的注释符号即可。关闭绿色波浪线提示run.py 中大量接口与模块名采用英文命名若部分代码下方出现绿色波浪线这是 PyCharm 的英文词语拼写检查提示可以点击项目名称左方的主菜单按钮【File】→【Settings】→【Editor】→【Inspections】→【Proofreading】取消【Typo】的勾选后点击【OK】确认回到主窗口后绿色波浪线即会消失。运行脚本在 run.py 上点击鼠标右键选择【Run run】即可开始运行。此时界面底部的终端内容输出区域会显示程序运行时的打印信息如 加载VeighNa Trader运行环境、初始化主引擎、注册交易接口、注册应用模块 等日志与此同时 VeighNa Trader 的主窗口也会自动弹出显示。回到 PyCharm项目界面右上角已经有 run 脚本的运行记录了后续直接点击三角形运行按钮即可再次运行该脚本无需重复右键操作。断点调试策略回测脚本PyCharm 的断点调试功能十分强大这里使用一个 VeighNa 的策略历史回测脚本来演示完整调试流程。创建回测脚本在左侧项目导航栏中点击鼠标右键选择【New】→【File】在弹出的对话框中创建backtest.py然后编写一段策略回测代码具体可参考本仓库的 examples/cta_backtesting/backtesting_demo.ipynb其使用vnpy_ctastrategy.backtesting模块的BacktestingEngine引擎通过set_parameters()配置合约、周期、时间段、手续费率、滑点、合约乘数、价格跳动与回测资金再通过add_strategy()加载策略后执行回测。回测脚本主体大致如下from datetime import datetime from vnpy.trader.optimize import OptimizationSetting from vnpy_ctastrategy.backtesting import BacktestingEngine from vnpy_ctastrategy.strategies.atr_rsi_strategy import AtrRsiStrategy engine BacktestingEngine() engine.set_parameters( vt_symbolIF888.CFFEX, interval1m, startdatetime(2019, 1, 1), enddatetime(2019, 4, 30), rate0.3 / 10000, slippage0.2, size300, pricetick0.2, capital1_000_000, ) engine.add_strategy(AtrRsiStrategy, {})运行回测前请确保数据库内已有足够的历史数据可通过 VeighNa Trader 的 CTA 回测模块下载或使用数据服务导入否则回测引擎会输出历史数据不足回测终止的提示。启动调试在想要调试的代码行左侧点击打上红色圆点断点例如engine.set_parameters(...)调用处在 backtest.py 上点击鼠标右键选择【Debug backtest】开始调试脚本启动调试后主界面底部出现 Debug 窗口程序会暂停运行在第一个断点处左侧显示线程信息右侧显示当前上下文中的变量信息。调试过程中的常用控制按钮Resume Program播放键继续运行调试直到下一个断点处再次暂停。此时底部右侧监控窗口中当前上下文中的变量会随程序推进发生变化可借此观察策略参数、引擎状态在回测各阶段的取值Step Into进入函数的内部查看运行时的细节状态例如进入set_parameters()内部逐行观察参数赋值Step Over越过子函数子函数会执行但不进入其内部Step Out跳出当前函数查看外层调用栈的状态Stop backtest直接停止当前程序的运行Rerun backtest调试结束后重新运行调试。项目界面右上角会记录 backtest.py 的运行记录后续可以通过点击这里的按钮直接启动调试任务。指定程序的运行目录在 PyCharm 新建项目时默认是在当前目录下运行程序。若需要指定程序运行的目录例如 VeighNa 需要以运行时目录为工作目录读取.vntrader下的配置文件可以点击项目界面右上角的【Edit】进入【Run/Debug Configurations】界面修改程序启动时的目录【Working directory】为指定路径即可。C 回调断点调试问题背景通常情况下PyCharm 只能在 Python 解释器中启动的线程里进行代码断点调试。部分用户反馈在 C 回调函数如 CTP API 接口、PySide 图形库等中打断点但无法起效。这是因为这些回调运行在 C 层面创建的线程中Python 调试器默认无法介入。针对这种情况可以通过在代码中手动设置断点的方式实现对非 Python 线程即 C 线程的断点调试。编写网关测试脚本在项目左侧导航栏中点击鼠标右键选择【New】→【File】创建gateway_test.py添加一段脚本策略的代码可参考本仓库的 examples/veighna_trader/demo_script.py其通过vnpy_scripttrader的ScriptEngine引擎完成行情订阅、合约查询与轮询行情输出。然后按住 Ctrl 同时用鼠标左键点击代码中的CtpGatewayPyCharm 会跳转至ctp_gateway.py的源码中该文件位于 VeighNa Studio 环境 site_packages 下的vnpy_ctp包内在想要调试的回调函数内打上断点注意不要打在函数定义的 def 那一行而要打在函数体内部的语句行。回到gateway_test.py点击鼠标右键选择【Debug gateway_test】开始调试。此时可观察到并没有进入之前设定的断点——这正是 C 回调线程无法被 Python 调试器捕获的表现。使用 pydevd 手动挂接调试器终止调试后找到之前在ctp_gateway.py中设定的断点处在回调函数内的断点之前添加以下代码import pydevd pydevd.settrace(suspendFalse, trace_only_current_threadTrue)请注意以下几点pydevd是 PyCharm 自带的调试插件没有安装在 Python 解释器所在的 Python 环境里因此在普通 Python 代码中直接 import 会失败只能在上述 C 回调场景中配合 PyCharm 的调试器使用suspend参数设置为 True 之后调试会在这一句代码运行完之后暂停而不是停在断点处示例代码中使用suspendFalse即挂接调试器但不立即暂停随后程序继续执行到真实断点处暂停trace_only_current_thread参数设置为 True 之后调试过程中只会监控当前线程避免调试器被其他线程的频繁运行干扰调试结束之后不要忘记删掉这段代码否则运行时会报pydevd未安装的错误。验证调试效果再次运行调试gateway_test.py脚本调试前请确保已通过load_json函数读取connect_ctp.json并在对应的.vntrader文件夹的 json 文件中配置了 CTP 账户登录信息——load_json是 VeighNa 框架中读取运行时配置文件的工具函数定义于 vnpy/trader/utility.py若文件不存在会自动创建空配置。此时可以看到底部的调试窗口中开始输出相关信息同时程序暂停在了之前设置的断点处左侧显示线程信息可以看到多了一个 Dummy 线程显示即 C 侧回调触发的线程右侧显示变量信息可以看到回调函数的入参如行情 Tick、委托回报等。通过这种方式即可像调试普通 Python 代码一样逐行观察 CTP 行情回调、报单回报回调等底层数据流的处理过程这对于排查交易接口层面的问题如行情字段异常、回报状态不匹配非常有帮助。与 VS Code 的对比最后给出 PyCharm 与 VS Code 在 VeighNa 开发场景下的两点关键差异Python 环境配置粒度在 PyCharm 中每个项目都需要对 Python 环境进行配置即前文【创建项目】一节的操作而在 VS Code 中默认通过窗口右下角的 Python 解释器选择器来选择全局的 Python 环境针对所有打开的文件项目级别的环境隔离需要额外通过.vscode/settings.json等配置实现Jupyter 支持PyCharm 的 Community 版仅对 Jupyter 提供了只读支持需要 Professional 版才能编辑和运行 NotebookVS Code 仅需安装功能插件就可以使用和 Jupyter 相关的全部功能包括读取、编辑、运行。如果用户的主要开发工作集中在策略研究与 Notebook 交互式分析上VS Code 的门槛更低如果需要完整的 Python 工程化开发体验断点调试、重构、测试等PyCharm 是更顺手的选择。两者均可与本文介绍的 VeighNa Studio 解释器无缝配合。小结本文从零开始完成了 PyCharm 与 VeighNa 开发环境的搭建绑定 VeighNa Studio 自带的 Python 3.10 解释器创建项目、通过 External Libraries 浏览 vnpy 核心框架与 vnpy_ 前缀插件模块源码、运行 examples/veighna_trader/run.py 启动 VeighNa Trader、对 examples/cta_backtesting/backtesting_demo.ipynb 对应的回测脚本执行断点调试并解决了 C 回调线程无法断点的痛点通过pydevd.settrace手动挂接调试器。掌握上述流程后即可在 PyCharm 中完成 VeighNa 的策略开发、回测调试与接口问题排查的日常闭环。更多环境与功能细节可继续参考仓库内的 Windows 安装指南、VeighNa Station 使用说明 与 CTA 回测模块文档。【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/gh_mirrors/vn/vnpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考