Ruby Debug：使用Debug Adapter Protocol的原生Ruby调试器

Ruby Debug是一款专门为VS Code设计的原生Ruby调试器，利用Debug Adapter Protocol提供强大而灵活的调试功能。尽管仍处于早期开发阶段，但已具备丰富的功能，旨在提升Ruby开发者的调试体验。

功能亮点：

• 多种断点支持： 包括标准、条件和命中计数断点（需要readapt >= 0.8.0）。
• 变量查看： 查看本地和全局变量数据。
• 调试控制： 支持下一行、步入、步出、暂停运行等操作。
• 表达式求值： 在调试控制台中评估表达式。
• 线程控制： 对单个线程进行控制。
• 堆栈跟踪： 可遍历的堆栈跟踪。
• 远程工作区支持： 支持远程调试。

使用要求：

Ruby Debug依赖于readapt gem。可以通过命令行安装：

gem install readapt

或者将它添加到项目Gemfile中：

gem 'readapt', group: :development

注意，readapt需要Ruby 2.2或更高版本。

使用指南：

如果您不熟悉VS Code的调试器，请参考调试器文档以获取更多信息。

快速开始

1. 在VS Code中打开Ruby项目文件夹。
2. 从活动栏进入调试视图。
3. 点击调试视图顶部的播放按钮（或使用F5快捷键）。（如果当前工作区没有启动配置，扩展将调试活动文件。）

工作区配置

点击调试视图顶部的下拉菜单，然后点击“添加配置”。

最简单的配置是“启动”。它将使用工作区中的Ruby文件启动调试器。默认行为是提示用户选择文件。您也可以将程序选项设置为特定文件；例如，“program”: "${workspaceFolder}/path/to/your/file.rb"。

调试外部程序

调试器还可以启动外部Ruby可执行文件。调试配置片段中包括了一个调试RSpec的示例。

使用Bundler

启动配置包括一个useBundler选项。如果为true，调试器将在启动程序前使用bundle exec readapt serve。

请注意，readapt必须包含在您的Gemfile中才能使用useBundler。

示例配置

以下片段展示了一些可以添加到launch.json中的常见启动配置。

调试活动文件

{
    "type": "ruby-debug",
    "request": "launch",
    "name": "Active File",
    "program": "${file}",
    "programArgs": [],
    "useBundler": false
}

调试活动RSpec文件

{
    "type": "ruby-debug",
    "request": "launch",
    "name": "RSpec (Active File)",
    "program": "rspec",
    "programArgs": [
        "-I",
        "${workspaceFolder}",
        "${file}"
    ],
    "useBundler": false
}

调试Rails

{
    "type": "ruby-debug",
    "request": "launch",
    "name": "Rails",
    "program": "${workspaceFolder}/bin/rails",
    "programArgs": ["s"],
    "useBundler": true
}

注意： 如果useBundler为true，请确保readapt gem已包含在您的Gemfile中，例如：

gem 'readapt', group: :development