Sublime Debugger

适用于支持调试适配器协议的 sublime text 的图形调试器。

参阅 调试适配器协议

安装

使用软件包控制运行 软件包控制: 安装软件包 并选择 调试器。

或者克隆到您的 sublime 软件包目录（如果您使用的是 Sublime Text 3，则使用 st3 分支）

入门指南

此项目试图与 Visual Studio Code 的调试器非常匹配，因此它们的文档可能非常有用。请参阅 https://vscode.js.cn/docs/editor/debugging

调试器

该项目附带一些预配置的调试器（可以使用 调试器: 安装适配器 进行安装）

LLDB

• 参阅 https://github.com/vadimcn/vscode-lldb

Chrome

• 参阅 https://github.com/Microsoft/vscode-chrome-debug

Firefox

• 参阅 https://github.com/firefox-devtools/vscode-firefox-debug

Node

• 概述请参阅 https://vscode.js.cn/docs/nodejs/nodejs-debugging
• 参阅 https://github.com/microsoft/vscode-node-debug2

Python

• 概述请参阅 https://vscode.js.cn/docs/python/debugging
• 参阅 https://github.com/Microsoft/vscode-python

Go

• 概述请参阅 https://github.com/golang/vscode-go/blob/master/docs/debugging.md
• 请参阅 https://github.com/golang/vscode-go

PHP

• 请参阅 https://github.com/felixfbecker/vscode-php-debug

Java

• 需要 LSP 和 LSP-jdtls
• 请参阅 https://github.com/redhat-developer/vscode-java

Emulicious调试器

• 请参阅 https://github.com/Calindro/emulicious-debugger

设置

• 通过命令面板打开调试面板

  • 从命令面板 调试器：打开

• 在命令面板中运行 调试器：安装适配器 以安装调试适配器。

• 从命令面板中添加配置 调试器：添加配置（或手动添加，见下文）。

  • 配置添加到 sublime-project 的 debugger_configurations 中，并使用与 Visual Studio Code 相同的配置格式。
  • 有关为您的调试器创建配置的说明，请参阅上面的调试器特定文档链接。大多数调试器都附带一些可选的配置片段，但我强烈建议查看调试器的文档。
  • 变量替换：支持像 ${file} 这样的变量，但支持的变量列表与 VSCode 不同。支持值请见 https://text.sublime.net.cn/docs/build_systems.html#variables，此外还有 VSCode 特定的 ${workspaceFolder}，它解析为第一个工作空间文件夹的路径。

• 您的配置可能如下所示，但包含一些调试器特定的字段。

"debugger_configurations" : [
    {
        "name" : "Name of your configuration",
        "request" : "launch"|"attach",
        "type" : "debugger name",
         ...
    }
]

• 开始调试
  • 点击齿轮图标选择要使用的配置
  • 点击播放图标启动调试器或运行 调试器：开始（如果没有选择配置，它将提示您选择或创建一个配置）

任务

任务基于 sublime build_systems，具有更多集成，因此可以在调试期间更无缝地使用。当运行任务时发生错误，它们将在调试器 UI 中报告（问题检测与 sublime 相同，您必须将 file_regex 添加到您的任务中）

请参阅 https://text.sublime.net.cn/docs/build_systems.html

任务基本上与 sublime 构建相同，但有几个附加参数。例如 name，将在调试器 UI 中显示并作为面板的名称

"debugger_tasks" : [
    {
        "name" : "Name of your task",
        "cmd" : ["task", "command"],
         ...
    }
]

• 可以使用 调试器：运行任务 运行任务
• 您可以通过将 pre_debug_task 或 post_debug_task 添加到您的配置中来在调试前后运行任务，指定要运行的任务的名称。

设置

可以用 首选项：调试器设置 来调整设置

有关设置的全列表，请参阅 debugger.sublime-settings

故障排除

• 要修复位置对齐错误或最后一个面板不可见的错误，请尝试调整设置中的 internal_font_scale 和 internal_widthModifier
• 在调试控制台中查找错误（通常是红色）
• 在 sublime 控制台中查找错误
• 在 Visual Studio Code 中尝试相同的配置/适配器（您的问题很可能与适配器有关，所以请查看其正在进行的错误）