RubyMine 2023.3 Help

Debug

RubyMine provides a debugger for Ruby code. Depending on the installed/enabled plugins, you can also debug code written in other languages, including the ERB and HAML files.

Debugging Ruby 2.0+ projects requires the debase and ruby-debug-ide gems added to the project interpreter. RubyMine will suggest installing these gems when you run debugging for the first time.

In order to install the debugging gems, RubyMine requires additional libraries:

  • Windows: Ruby+DevKit

  • macOS: Command Line Tools

  • Linux: The build-essential package

Using byebug or similar debugging gems in your project may affect the RubyMine debugger. We recommend disabling such gems to prevent slowdowns or unexpected behavior.

RubyMine's debugger works with debug version 1.6.2 and later. Note that this gem version requires Ruby MRI 2.6 and later.

General debugging procedure

  1. (Optional) Configure the debugger settings in the Settings | Build, Execution, Deployment | Debugger page.

  2. If necessary, create or modify an existing run/debug configuration.

  3. Place breakpoints in your code.

  4. Start the debugger session.

  5. During a debug session, examine the program state: see variable values, evaluate expressions, and so on. You can also use the Debug console to do this.

  6. Step through the program.

Last modified: 11 January 2024