Qore VSCode扩展：为Visual Studio Code增强Qore语言支持

Qore VSCode扩展是为Visual Studio Code设计的插件，旨在为开发者提供全面的Qore语言支持。无论您是新手还是经验丰富的Qore开发者，该扩展都能帮助您更高效地编写和调试Qore代码。

最新版本更新：

• 版本0.8.4 (2023-11-18)：修复了扫描目录中存在UNIX套接字文件时的错误。
• 版本0.8.3 (2023-11-15)：解决了Qore语言服务器在扫描目录中存在不可读文件时的错误。
• 版本0.8.2 (2023-06-26)：通过更新至最新的内部VSCode API，彻底修复了手动安装Qore时扩展报告Qore不可用的问题。
• 版本0.8.1 (2023-06-06)：更新模块以使用适用于macOS Catalina的x86_64 Qore包构建，以确保最大向后兼容性。
• 版本0.8.0 (2023-05-25)：修复了手动安装Qore时扩展报告Qore不可用的错误，并更新Qore包至v1.16.0。
• 版本0.7.7 (2022-05-10)：更新qls以避免与新版本Qore的警告。
• 版本0.7.6 (2022-05-10)：为所有关联的Qore文件添加了Qore语言图标。

依赖要求：

• Qore 0.9.3（包括qdbg-vsc-adapter）必须安装，以支持所有功能，包括调试支持。
• Qore 0.8.13（包括astparser和json模块）必须安装，以支持除调试以外的所有功能。

在Windows和macOS上，如果未安装Qore，激活扩展时将显示警告消息，询问您是否要下载Qore VSCode包。如果选择“是”，将下载并安装Qore包至扩展目录中。这将为Qore语言服务器提供必要的Qore和模块。

功能亮点：

• 语法高亮
• 悬停信息
• 跳转定义
• 查找引用
• 文档符号搜索
• 工作区符号搜索
• 语法错误报告
• 调试器（需要Qore 0.9.3及qdbg-vsc-adapter）

除语法高亮外，大多数功能由QLS（Qore语言服务器）提供。为了使QLS正常工作，您需要在系统上安装Qore 0.8.13，包括astparser和json模块。

QLS日志记录：

如果您想记录QLS的输出，可以使用以下配置设置：

• qore.useQLS：布尔标志，用于开启/关闭使用QLS提供Qore代码信息。[默认=true]
• qore.logging：布尔标志，用于设置日志记录开关。[默认=false]
• qore.logFile：字符串，指定QLS日志文件路径。如果开启日志记录，所有操作将记录到此文件中。如果未定义，Unix-like系统使用~/.qls.log，Windows使用%AppData%\QLS\qls.log。
• qore.logVerbosity：QLS日志记录的详细程度。从0到2。[默认=0]
• qore.appendToLog：布尔标志，指定是否追加到QLS日志文件中还是每次重启时覆盖。[默认=true]

调试功能：

调试会话在调试视图引用的launch.json文件中配置。该扩展实现了qore调试类型。调试器可以执行本地调试主机上的Qore脚本，或附加到远程qdbg-server主机。

在第一种情况下，请求值为launch，program指定Qore脚本文件名。在后一种情况下，请求值为attach，connection指定连接的URL，program为要调试的程序名。

请注意，VSCode宏和命令会被展开。该扩展为launch情况实现了${command:AskForFilename}，为attach情况实现了${command:AskForConnection}和${command:AskForProgram}，以便在调试会话启动时指定值。

要开始调试，请准备launch文件，从下拉菜单中选择配置，然后点击开始调试。当指定程序执行时，扩展会收到通知，程序会被中断，然后用户可以开始逐步执行代码，检查堆栈、变量等。要退出程序逐步执行，请按F5。

以下是launch文件数据结构的一个示例：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "qore",
            "request": "launch",
            "name": "Ask for file name",
            "program": "${workspaceFolder}/${command:AskForFilename}"
        },
        {
            "type": "qore",
            "request": "attach",
            "name": "Ask for conection and program",
            "connection": "${command:AskForConnection}",
            "program": "${command:AskForProgram}"
        },
        {
            "type": "qore",
            "request": "launch",
            "name": "Launch test-basic.q",
            "program": "test-basic.q",
        },
        {
            "type": "qore",
            "request": "attach",
            "name": "Attach test-program",
            "connection": "ws://localhost:8001",
            "program": "test-program",
        }
    ]
}

通过Qore VSCode扩展，您可以充分利用Qore语言的强大功能，提升开发效率和代码质量。