VeighNa Elite 安装配置指南Windows 环境下的安装、卸载与运行目录管理【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/gh_mirrors/vn/vnpy本篇技术指南以 vnpy 开源仓库中 docs/elite/info/elite_install.md 为骨架系统讲解 VeighNa Elitevnpy 项目面向机构与进阶用户提供的商业版量化交易平台在 Windows 系统下的完整安装流程、卸载方式、独立环境隔离机制与用户数据目录管理方法。读完本文你将能够独立完成 VeighNa Elite 的安装向导操作、理解默认安装目录C:\veighna_elite的约定、正确区分卸载程序与清除用户数据两种操作并掌握.vntrader用户目录的底层存储原理为后续使用 VeighNa Elite Trader 交易端 与 VeighNa Elite Lab 投研端 打下基础。支持的操作系统根据 elite_install.mdVeighNa Elite 安装步骤适用的操作系统包括Windows 10/11Windows Server 2019/2022其他版本的 Windows 系统安装时可能遇到各种依赖库问题不推荐使用。需要注意官方文档将适用范围严格限定在上述系统版本说明 VeighNa Elite 的安装包与运行环境针对这些系统做了适配验证在更老的 Windows 版本如 Windows 7/8上运行可能因缺少 VC 运行库、.NET 组件或系统 API 差异而出现依赖问题。这与开源版 vnpy 主要面向 Linux/Windows 双平台开发的定位不同Elite 商业版目前以 Windows 桌面环境为主要运行载体。安装流程安装VeighNa Elite 采用图形化安装向导安装包方式分发整体安装过程如下下载安装包获取 VeighNa Elite 安装包文件。以管理员身份运行双击安装包进入 VeighNa Elite 安装向导。官方文档明确推荐点击右键选择【使用管理员身份运行】进行安装——以管理员权限运行可以避免在安装过程中因目录写入权限、环境变量注册等系统操作被 UAC用户账户控制拦截导致的安装失败或组件缺失。选择安装目录在安装向导中点击【下一步】按钮即可进入安装目录选择页面。推荐将 VeighNa Elite 安装在默认路径C:\veighna_elite。其他 VeighNa Elite 文档和教程中均使用该目录作为 VeighNa Elite 安装目录进行讲解即后续 交易端使用文档、投研环境文档 以及各类策略开发教程中出现的路径约定均以此目录为基准。执行安装选择完安装目录之后点击【安装】按钮即可开始安装向导会显示安装进度。安装完成安装完成后向导会转换到安装成功页面。启动程序安装成功后桌面会出现VeighNa Elite Trader和VeighNa Elite Lab两个图标双击图标即可运行对应程序VeighNa Elite Trader面向实盘交易的主程序用于连接交易接口、加载策略应用、进行交易监控与全局配置详见 VeighNa Elite Trader 基础交易功能VeighNa Elite Lab面向量化投研的 Jupyter 开发环境用于运行 Notebook、Python 交互式命令与策略回测研究详见 VeighNa Elite Lab 投研开发环境。从 docs/elite/info/index.rst 的目录结构可以看出安装使用部分正是由elite_install.md、elite_trader.md、elite_lab.md三篇文档组成安装完成后的第一件事就是分别进入 Trader 与 Lab 完成登录使用因此本节是整条 Elite 使用链路的起点。卸载如需卸载 VeighNa Elite可在 Windows 系统中打开【设置】→【应用】→【应用和功能】找到VeighNa Elite进行卸载。这里需要特别注意卸载程序与清除用户数据是两种不同粒度的操作详见下文用户信息一节仅执行系统卸载只会移除程序本体不会删除用户目录下的配置与数据若需要连用户数据一起清除则必须在卸载后手动删除.vntrader用户目录。注意事项独立环境VeighNa Elite 采用独立的 Python 运行环境自带解释器与依赖库不会与 VeighNa Studio 等其他 Python 环境冲突因此同一台机器上可以同时安装 VeighNa Studio社区版与 VeighNa Elite商业版而互不干扰。如需在 VeighNa Elite 中使用其他 Python 模块可以通过PYTHONPATH 环境变量加载。这一机制与开源版 vnpy 的运行目录设计一脉相承在 vnpy/trader/utility.py 中_get_trader_dir()函数会优先检查当前工作目录下是否存在.vntrader文件夹若存在则将其作为运行目录否则回退到系统用户主目录Path.home()下的.vntrader并在不存在时自动创建# vnpy/trader/utility.py def _get_trader_dir(temp_name: str) - tuple[Path, Path]: cwd: Path Path.cwd() temp_path: Path cwd.joinpath(temp_name) # If .vntrader folder exists in current working directory, # then use it as trader running path. if temp_path.exists(): return cwd, temp_path # Otherwise use home path of system. home_path: Path Path.home() temp_path home_path.joinpath(temp_name) # Create .vntrader folder under home path if not exist. if not temp_path.exists(): temp_path.mkdir() return home_path, temp_path TRADER_DIR, TEMP_DIR _get_trader_dir(.vntrader) sys.path.append(str(TRADER_DIR))可以看到.vntrader目录还会被追加进sys.path这意味着放在该目录下的自定义模块可以直接被 import——这正是通过 PYTHONPATH 环境变量加载其他模块这一做法在代码层面的落点用户可以借此将自研的公共模块、数据服务封装等注入 Elite 运行环境。用户信息VeighNa Elite 的用户信息缓存在用户目录下的.vntrader文件夹中这是理解整个 Elite 数据管理的关键清除数据如果卸载时需要清除用户数据及配置信息需要将.vntrader文件夹手动删除卸载程序本身不会自动清理该目录保留配置如果只是重新安装例如版本升级、修复安装只卸载程序即可重装之后配置信息无需重新填写——因为.vntrader目录依然保留在用户主目录下。以开源版 vnpy 的源码为参照可以进一步理解.vntrader目录内部都存放了什么全局配置 vnpy/trader/setting.py 中的全局设置字典SETTINGS会通过load_json(SETTING_FILENAME)从.vntrader目录下的vt_setting.json文件加载覆盖项字体、日志、邮件、数据服务、数据库等配置均持久化于此# vnpy/trader/setting.py SETTINGS: dict { font.family: 微软雅黑, font.size: 12, log.active: True, log.level: INFO, log.console: True, log.file: True, email.server: smtp.qq.com, email.port: 465, ... } # Load global setting from json file. SETTING_FILENAME: str vt_setting.json SETTINGS.update(load_json(SETTING_FILENAME))而 vnpy/trader/utility.py 中的get_file_path()/load_json()/save_json()等函数正是把各类 json 配置文件统一读写到.vntrader目录下的实现TEMP_DIR.joinpath(filename)。VeighNa Elite Trader 登录界面中保存的接口配置、策略应用加载记录等也遵循同样的写盘 → 下次启动自动读取机制这正是文档所述重装之后配置信息无需重新填写的原因。日志文件根据 VeighNa Elite Trader 使用文档 中的全局配置-日志一节日志文件默认位于运行时目录的.vntrader\log目录下完整路径形如C:\users\administrator\.vntrader\log其中administrator为当前 Windows 系统的登录用户名。也就是说实际路径会随系统登录用户变化即上文源码中Path.home()所解析到的用户主目录。安装后快速上手完成安装并启动两个桌面图标后可以按以下顺序快速验证安装是否成功双击VeighNa Elite Trader在弹出的登录界面中输入用户名与密码登录若检测到新版本会先弹出【更新提示】窗口点击【Yes】立即更新或【No】跳过在登录界面下方的【交易接口】与【策略应用】标签页中添加所需接口与应用配置信息将保存到本地.vntrader目录下次启动无需重复填写双击VeighNa Elite Lab登录后在右下角选择运行目录点击【启动】即可打开 Jupyter 环境进行投研。以上步骤的完整说明分别见 VeighNa Elite Trader 使用文档 与 VeighNa Elite Lab 使用文档两者与本文共同构成 Elite 版安装使用章节 的完整内容。小结VeighNa Elite 的安装配置以 Windows 图形化向导为核心关键要点可以概括为四点要点说明系统要求Windows 10/11、Windows Server 2019/2022其他版本不推荐默认安装目录C:\veighna_elite全套教程均以此路径为基准管理员权限推荐右键【使用管理员身份运行】安装避免权限导致的安装问题数据目录用户信息与配置缓存于用户主目录下.vntrader删除即清空全部用户数据环境隔离独立 Python 环境不与 VeighNa Studio 冲突可通过 PYTHONPATH 加载外部模块理解.vntrader目录的定位尤其重要它既是接口配置、全局配置的持久化位置对应 setting.py 的vt_setting.json加载机制也是日志文件的存放位置更是判断重装是否需要重配以及卸载后是否残留用户数据的关键依据。将卸载程序与删除.vntrader两种操作区分清楚即可在日常升级、换机迁移、彻底清理等场景中游刃有余。【免费下载链接】vnpy基于Python的开源量化交易平台开发框架项目地址: https://gitcode.com/gh_mirrors/vn/vnpy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考