VYPcode Extension：为Visual Studio Code添加VYPcode语言支持

VYPcode Extension是一款专为Visual Studio Code设计的插件，旨在为VYPcode语言提供全面的支持，包括语法高亮、调试和解释功能。通过此扩展，您可以显著提升在VYPcode编程中的开发效率和调试体验。

依赖环境：

• 需要Visual Studio Code 1.49.0或更高版本
• 需要Java 8解释器
  • 预设可以通过java命令运行，如需更改，请在设置或调试配置中调整
  • 使用默认的集成终端进行解释和调试

功能详情：

文件检测

该扩展定义了VYPcode语言的语法规则，供VS Code进行语法高亮。文件语言通过文件扩展名进行识别，支持的VYPcode文件扩展名包括：.vypc、.vypcode、.vc。

调试器

扩展增加了调试类型vypc，可在launch.json文件中配置调试。当前打开的文件若被识别为VYPcode文件，工具栏右上角将显示两个按钮，可用于调试或运行当前文件。

设置程序值

在VARIABLES视图中，您可以更改寄存器、堆栈和单个块项的值。新值可以是整数或浮点数，格式与源代码一致。无法编辑整个块。

值监视

WATCH视图可用于显示特定值。寄存器和堆栈值的标识方式与源代码一致。块可以通过其ID显示，单个块项通过块标识符和索引访问。

• 寄存器：以美元符号开头，后跟数字或寄存器名称，如$0、$NAME
• 堆栈项：用方括号表示的表达式（堆栈寻址），如[5]、[$1 8]
• 块：块ID的整数，如1
• 块项：块ID和整数索引，如1[0]

值默认以十进制显示，与VARIABLES视图一致。浮点格式可以通过在值标识符末尾添加格式说明符来实现。格式说明符以百分号%开头，后跟指定格式的字母（不区分大小写）。

• d：默认十进制格式
• a：十六进制浮点格式（用于打印浮点数）
• f：标准浮点格式

评估指令

调试时，可以使用DEBUG CONSOLE评估额外指令。程序执行必须暂停（例如在断点处或通过暂停按钮）。评估支持与普通VYPcode程序相同的指令，但不包括LABEL指令、READx指令和调试指令。评估指令的输出重定向到调试控制台。评估指令会更改调试程序的状态。在控制台评估指令时可能出现的错误不会终止调试程序。

新增命令：

扩展增加了两个命令，用于启动和调试当前打开的文件。这些命令可以通过点击前面提到的按钮使用，也可以通过命令面板运行（默认打开快捷键为Ctrl Shift P），无论打开的文件是什么语言，都可以使用。

• VYPcode: Debug：以调试模式启动当前打开的文件
• VYPcode: Run：执行当前打开的文件

解释VYPcode程序

扩展包含一个带有解释器的调试适配器jar文件。默认情况下，此适配器用于通过以调试模式启动并使用noDebug参数来执行VYPcode程序，这会导致适配器阻塞性地执行程序（忽略所有调试命令直到程序结束）。建议设置VYPcode解释器jar文件的路径，以便使用。

调试配置：

每个调试配置必须包含三个属性：type、request和name。除了这些，还需要program属性。

• request：如何开始调试，仅支持选项launch
• name：配置名称，任意
• type：调试类型，对于VYPcode程序为vypc
• program：要调试的程序路径
• stopOnEntry：调试开始时是否在第一条指令前停止
• args：传递给解释器的参数数组，例如["--stack", "10"]
• port：运行调试适配器服务器的默认端口
• javaPath：要使用的Java解释器路径

设置：

扩展的设置在VYPcode下可用。这些设置覆盖默认值，但优先级低于调试配置。它们的用途与调试配置相同。

• Port
• Java Path
• Version
• VYPcode Interpreter：VYPcode解释器jar文件的路径