V3版本新增的内置代码编辑器是其迈向一站式开发环境的最重要标志。它并非一个简单的文本编辑工具,而是一个功能完整的VS Code(Visual Studio Code)核心实例,旨在为您提供专业、高效、无缝的策略编写与调试体验。

1. 全新功能,一睹为快
1.1 完整的 VS Code 核心体验
现在,您可以直接在KhQuant客户端内部,拥有VS Code的强大功能,包括:
* 熟悉的界面与操作:对于VS Code的老用户,无需任何学习成本,即刻上手。
* 强大的插件生态:您可以自由安装海量的VS Code插件,例如各类AI编程助手、主题、代码检查工具等,极大地扩展了编辑器的能力。
* 智能代码提示与补全:安装Python官方插件后,即可拥有顶级的代码分析和智能提示服务。
* 和谐的视觉体验:内置VS Code的界面主题与KhQuant系统保持统一,确保了视觉上的和谐与美观。

1.2 与看海客户端的无缝联动
内置编辑器与看海客户端紧密关联,实现了真正的“一体化”开发调试体验。
* 自动加载策略:在主界面左侧配置面板中设置好策略文件路径后,点击“策略编辑器”菜单,系统会自动在VS Code中打开对应的策略文件。
* 自动进入调试模式:在编辑器打开的状态下,从主界面点击“开始回测”,系统将自动启用调试模式。您可以在代码中设置断点,对策略进行单步跟踪、查看变量,深入洞察策略运行的每一个细节。

1.3 零配置,开箱即用
为了让您能专注于策略逻辑本身,所有繁杂的后台配置都已由系统自动化处理:
* 自动生成调试配置:系统会在您的工作区内自动创建并配置好.vscode/launch.json文件。
* 自动配置Python环境:系统会自动生成.vscode/settings.json文件,将Python解释器指向当前环境,并配置好代码补全路径,完美解决khQuant库导入无代码提示的问题。
* 独立纯净的环境:内置VS Code拥有独立的扩展和用户数据目录,与您电脑上可能已有的其他VS Code环境完全隔离,互不干扰。
2. 调试流程指南
温馨提示:断点调试功能主要面向具备一定Python代码基础的用户,是精准定位代码问题的利器。
准备工作:安装VS Code本体
为了尽可能控制看海安装包的体积,并允许用户自由升级和管理VS Code,VS Code软件本身并未被打包进看海安装包中。因此,在首次使用前,您需要先在您的电脑上安装VS Code。
* 下载地址:https://code.visualstudio.com/download
调试步骤
安装好VS Code后,就可以按照以下步骤开始您的首次调试:
第一步:选择策略文件
在看海客户端主界面,首先通过左侧配置面板,选择您希望进行编辑和调试的策略文件。

第二步:启动编辑器并安装Python插件 (首次)
点击主界面工具栏上的【编辑器】按钮。

* 首次启动时:VS Code通常会在窗口右下角提示您安装推荐的“Python”扩展。请务必点击Install进行安装。这是获得代码提示、语法高亮和调试能力的关键。

第三步:设置断点
Python插件安装完成后,在编辑器中找到您关心的代码行(例如,一个买入/卖出条件的判断行),在行号的左侧空白处单击鼠标,即可设置一个红色的断点。

第四步:开始调试
回到看海主界面,点击中间面板的“开始运行!”按钮。
- 触发调试:策略代码将会正常执行,直到运行至您设置了断点的代码行处会自动暂停。
- 自动聚焦:此时,内置VS Code窗口将自动弹出并获得焦点,进入调试视图。您可以在此清晰地看到当前所有变量的值,并使用顶部的调试工具栏进行单步执行、继续执行等操作,彻底洞察策略运行的每一个瞬间。


