VeighNa (vnpy) 作为国内领先的开源量化交易框架，以其强大的功能和灵活的扩展性深受开发者喜爱。然而，对于初次接触的用户来说，安装过程中的依赖问题，特别是因官方不再维护旧版 TA-Lib 库而导致的编译困扰，常常成为入门的「拦路虎」。本文旨在提供一份面向 2025 年的最新、最简便的 vnpy 安装指南，我们将直接从 GitHub 仓库拉取最新源码进行安装，从而完美避开版本依赖陷阱，帮助您快速搭建起稳定可靠的本地量化研究与交易环境。
前备条件
- Microsoft Visual C++ Build Tools/C++生成工具（可选）：访问微软官方下载页面：Visual Studio Build Tools，点击 “下载生成工具”，安装必须的 C++ 组件，只有在使用老旧的 TA_Lib‑0.4.24 时才需要用到，因为 TA_Lib 官方（作者）已经不再提供该版本下载了，需要自行编译；
- Git（可选）：我们通过 git 拉取仓库到本地，也可以下载仓库 zip 包后解压使用；
- Conda/miniconda（可选）：本文在虚拟环境下安装 vnpy，可以在这里下载、安装，你也可以不使用虚拟环境，但非常不建议；
- Python 3.13（可选）：本文使用系统默认的 python 3.13，VeighNa 支持 3.10+ 以上版本的 python，也可以像下文给出的示例命令一样，在虚拟环境创建时通过“ python=3.13”指定、安装专用的 python。
安装过程
拉取 vnpy 仓库并创建虚拟环境。记住：不要下载社区官方发布列表中的 zip 或 tar 包，2025 年仍然使用 0.4.24 版本的 TA_Lib 会让你抓狂。
git clone https://github.com/vnpy/vnpy.git cd vnpy conda create -n vnpy_env python=3.13 conda activate vnpy_env
在虚拟环境下运行 install.bat 文件，安装依赖。以下所有命令均在虚拟环境下完成。
.\install.bat
创建 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_ctastrategy import CtaStrategyApp
from vnpy_ctabacktester import CtaBacktesterApp
def main():
"""Start VeighNa Trader"""
qapp = create_qapp()
event_engine = EventEngine()
main_engine = MainEngine(event_engine)
main_engine.add_gateway(CtpGateway)
main_engine.add_app(CtaStrategyApp)
main_engine.add_app(CtaBacktesterApp)
main_window = MainWindow(main_engine, event_engine)
main_window.showMaximized()
qapp.exec()
if __name__ == "__main__":
main()
安装依赖包。
pip install vnpy_ctp vnpy_ctastrategy vnpy_ctabacktester importlib_metadata vnpy_sqlite
运行程序，你将看到如下的界面。
python run.py
如果此时您已成功看到 VeighNa Trader 的主界面，那么一个功能齐全的本地量化交易平台已经搭建完成。透过本文指引，您不仅成功运行了程序，更重要的是掌握了从源码安装的最新方法，为后续的深度开发和自订打下了坚实基础。接下来，您可以开始探索如何配置交易接口 (如文中的 CTP)、编写您的第一个 CTA 策略或是利用回测模组来验证交易思路了。为了进一步简化您的部署流程，我们还提供了下方的全自动安装脚本，助您一键完成所有配置，轻松开启您的量化交易学习之旅。
<
更多精彩内容，敬请关注「老E的博客」！
文章评论