huanzai/SublimeDebugger

Graphical Debugger for Sublime Text for debuggers that support the debug adapter protocol

说明

lua-debug for Sublime

拷贝自 sublime_debugger，目标是支持 lua-debug

目标

使 sublime 也支持 lua-debug(原 actboy168，本作者改进版)，操作体验与 vscode 一致。

说明：lua-debug 改进了原无法随时开启 debugger 的问题。

安装

• 安装 Sublime Debugger 插件 （作者 改进版）
  • 在 sublime 执行 ctrl+shift+p，输入 Add Repository，输入：https://github.com/huanzai/SublimeDebugger
  • 在 sublime 再次执行 ctrl+shift+p，输入 Install Package，输入并选中：SublimeDebugger
• 首次安装 lua-debug
  • 打开项目工程（有无 project 均可），执行 F5
  • 选择 Install Adapters - lua

使用

lua-debug 支持无 project 模式（即不需要创建 sublime-project），支持读取 .vscode/launch.json 配置（与 vscode 保持一致），一份配置即可。

• F5 开启 Debugger ，首次需要选择一下你的配置 Debugger
• F10 下一行
• F11 进入方法
• Shfit+F11 退出方法

用例

• examples/mylua
• examples/mylua_without_project

Sublime Debugger

Graphical Debugger for sublime text for debuggers that support the debug adapter protocol.

See Debug Adapter Protocol

Installing

Using package control run Package Control: Install Package and select Debugger.

or clone into your sublime Packages directory (If you are on Sublime Text 3 use the st3 branch)

Getting Started

This project attempts to match Visual Studio Code's Debugger fairly closely so their documentation can be pretty helpful. See https://code.visualstudio.com/docs/editor/debugging

Debuggers

This project comes with some pre-configured debuggers (They can be installed using Debugger: Install adapters)

LLDB

• See https://github.com/vadimcn/vscode-lldb

Chrome

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

Firefox

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

Node

• For an overview see https://code.visualstudio.com/docs/nodejs/nodejs-debugging
• See https://github.com/microsoft/vscode-node-debug2

Python

• For an overview see https://code.visualstudio.com/docs/python/debugging
• See https://github.com/Microsoft/vscode-python

Go

• For an overview see https://github.com/golang/vscode-go/blob/master/docs/debugging.md
• See https://github.com/golang/vscode-go

PHP

• See https://github.com/felixfbecker/vscode-php-debug

Java

• Requires LSP and LSP-jdtls
• See https://github.com/redhat-developer/vscode-java

Emulicious Debugger

• See https://github.com/Calindro/emulicious-debugger

Setup

• Open the debug panel

  • from the command palette Debugger: Open

• Install a debug adapter by running: Debugger: Install adapter from the command palette.

• Add a configuration Debugger: Add Configuration from the command palette (or add one manually, see below).

  • Configurations are added to debugger_configurations to your sublime-project and use the same configuration format as Visual Studio Code
  • Consult the debugger specific documentation links above for creating a configuration for your debugger. Most debuggers come with some configuration snippets to choose from but I highly recommend looking at the documentation for the debugger.
  • Variable substitution: variables like ${file} are supported but the list of supported variables differs from VSCode. The supported values are those listed at http://www.sublimetext.com/docs/build_systems.html#variables plus the VSCode-specific ${workspaceFolder} that resolves to the path of the first workspace folder.

• Your configuration will look something like the following but with some debugger specific fields.

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

• Start debugging
  • click the gear icon to select a configuration to use
  • click the play icon to start the debugger or run Debugger: Start (if no configuration is selected it will ask you to select or create one)

Tasks

Tasks are based on sublime build_systems with more integration so they can be used more seamlessly while debugging. When errors occur while running a task they are reported in the debugger ui (problem detection is the same as sublime, you must add file_regex to your task)

see https://www.sublimetext.com/docs/build_systems.html

Tasks are basically the same as sublime builds but there are a few additional parameters. name which will show up in the debugger UI and be the name of the panel

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

• Tasks can be run with Debugger: Run Tasks
• You can run tasks before and after debugging by adding pre_debug_task or post_debug_task to your configuration specifying the name of the task to run.

Settings

Settings can be adjusted with Preferences: Debugger Settings

for a full list of settings see debugger.sublime-settings

Troubleshooting

• To fix issues with things aligning correctly or the last panel not being visible try adjusting the internal_font_scale and internal_width_modifier in the settings
• Look in the debug console for errors (usually red)
• Look in the sublime console for errors
• Try the same configuration/adapter in Visual Studio Code (There is a good chance your issue is with the adapter so check out the outstanding issues for it)