如何在Jekyll站点中搭配VS Code使用Ruby调试器？

1. 安装Ruby调试扩展 #

在VS Code扩展市场安装Ruby Debugger（或集成了调试功能的Ruby LSP，同时支持代码补全）。

2. 创建调试配置文件 #

打开Jekyll项目后，按Ctrl+Shift+D打开「运行和调试」面板，点击「创建launch.json文件」并选择「Ruby」环境。

3. 配置launch.json #

替换默认配置为Jekyll构建专属配置，根据你的依赖管理方式二选一：

直接使用Jekyll命令 #

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Jekyll Build",
      "type": "ruby",
      "request": "launch",
      "program": "${env:GEM_HOME}/bin/jekyll", // 若路径不对，可替换为jekyll的绝对路径（如/usr/local/bin/jekyll）
      "args": ["build", "--trace"],
      "cwd": "${workspaceFolder}",
      "env": {"JEKYLL_ENV": "development"}
    }
  ]
}

通过Bundler管理依赖（项目含Gemfile） #

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Jekyll Build (Bundler)",
      "type": "ruby",
      "request": "launch",
      "program": "${env:GEM_HOME}/bin/bundle",
      "args": ["exec", "jekyll", "build", "--trace"],
      "cwd": "${workspaceFolder}"
    }
  ]
}

4. 设置断点 #

在项目的Ruby代码文件（如_plugins下的自定义插件、主题中的Ruby逻辑文件）中，点击行号左侧空白处添加断点。注意：Liquid模板无法直接设断点，需将模板逻辑抽为Ruby插件后再调试。

5. 启动调试 #

在「运行和调试」面板选择对应的配置，点击绿色启动按钮。构建流程执行到断点时会自动暂停，你可以像调试C++一样查看变量、单步执行、调用栈回溯等。

关键注意事项 #

• 按Ctrl+Shift+P执行Ruby: Select Interpreter，确保VS Code使用正确的Ruby版本。
• --trace参数必须添加，它会强制Jekyll以调试模式运行，保证断点能被命中。

内容的提问来源于stack exchange，提问作者benui