JetBrains Rider 2019.2 Help

Debugger

File | Settings | Build, Execution, Deployment | Debugger for Windows and Linux
JetBrains Rider | Preferences | Build, Execution, Deployment | Debugger for macOS
Ctrl+Alt+S the Settings/Preferences icon


Use this page to configure behavior of the Debugger and customize its view.

Common options

Item

Description

Focus application on breakpoint

If this checkbox is selected, on hitting a breakpoint, JetBrains Rider will show the location of this breakpoint in the editor and will attempt to bring its frame to the front.

Show debug window on breakpoint

If this checkbox is selected, JetBrains Rider activates the Debug window on hitting a breakpoint.

Hide debug window on process termination

Automatically hide the Debug window when the debugged program terminates.

Scroll execution point to center

If this checkbox is selected, the line with the current execution point will be kept in the middle of the screen.

Click line number to perform run to cursor

If this checkbox is selected, you can click a line number in the editor to run program execution to this line.
JetBrains Rider debugger: Run to statement using the line number

Remove breakpoint

Select how you want to remove breakpoints:

  • By clicking them with the left mouse button

  • By dragging them to the editor or clicking them with the middle mouse button. In this case, clicking a breakpoint will toggle its state between enabled and disabled.

You can also choose whether you want a confirmation dialog to be displayed when you are about to remove a conditional or a logging breakpoint

All Languages

Item

Description

Allow editing in the debug mode

This checkbox only affects files of non-.NET languages (for example, JavaScript or TypeScript files). In .NET languages, you can edit and continue, which is controlled with the Enable Edit And Continue checkbox below on this page.

The checkbox is disabled by default because when you edit code in the debug mode, it is no longer synchronized with the debugger and can lead to unexpected results.
If Show prompt to allow editing is enabled, you will be able to edit files after accepting a warning that appears on each edit attempt. Otherwise, editing of files of non-.NET languages will be blocked when you are in the debug mode.

.NET Languages

Item

Description

Save all files on debugger launch

If this checkbox is enabled, all files are saved automatically when you start debugging to make sure that the files are synchronized with the debugger.

Show breakpoint preview on mouse hover

If this checkbox is enabled, JetBrains Rider will show a preview icon when you hover your mouse over a line where it is possible to set a breakpoint:

JetBrains Rider: Breakpoint suggestion on mouse hover

Disable JIT optimization on module load (.NET/.NET Core only)

This option (which is on by default) suppresses optimization made by the just-in-time (JIT) compiler. This means that the non-optimized code will be executed slower but it will match the source code.
Normally, you need this option to be enabled unless you are debugging a problem that cannot be reproduced in the non-optimized code.
If you clear this option, the debug information that JetBrains Rider displays could be limited.
Note also that when you attach to a running process, the JIT optimization will be only disabled for modules that are loaded after you attach.

Enable external source debug (.NET/.NET Core only)

Enables automatic decompilation and debugging of external code.
If this option is disabled, you can still navigate to the external code and set breakpoints there. However, breakpoints in external code will be ignored by the debugger and you will not be able to step into the external code. So your debugging experience will be limited by the source code in your solution.

Ask for location of missing source files

Show floating debugger actions

If this option is enabled, you can hover the mouse over a target statement and use the icons that appear to run to cursor and jump to statement:

JetBrains Rider debugger: Run to statement with the hover action

Editing during debug

Enable Edit And Continue (.NET/.NET Core only)

When this option is on, you can edit your code and continue debugging without restarting.

There are cases when modifying the code is not possible and a restart is required. These include changing signatures, modifying generic functions, renamings of any kind, and some more. If this happens JetBrains Rider will make you aware by showing a tooltip.

Value inspections

Allow property evaluations and other implicit function calls

Enables automatic evaluation of properties and implicit function calls in the Debug window.

Evaluation timeout

Defines the timeout, after which a method call is aborted.

Refresh watched values on debugger pause

Show hex value for integers

Show return values

Show fully qualified type names

Flatten hierarchy of object members presentation

Exceptions

Break on user-unhandled exceptions (.NET/.NET Core only)

Select this option to break and debug unhandled exceptions.

Process exceptions outside of my code (.NET/.NET Core only)

Break on unhandled exceptions

Just-in-Time debugger

This set of options lets you configure the default just-in-time (JIT) debugger for your system. You can see the current JIT debuggers for 32 bit and 64 bit process and use the buttons to set JetBrains Rider as the default debugger or restore the one which was set default previously.

When JetBrains Rider is set as the default JIT debugger and a process calls Debugger.Launch, you will see a dialog that helps you choose how to start the debugger. (1) If the solution with the application source code is open, you can pick it from the list of opened solutions.
Alternatively, you can choose a JetBrains Rider installation. In this case, debugger will start in an empty solution, and you will be able to debug decompiled code of the process. An additional checkbox allows you to remember the selected option (2), in which case for every future attempt, the debugger will be attached automatically:

JetBrains Rider: Choosing how to launch just-in-time debugger

Built-in server

Item

Description

Port

Use this spin box to specify the port on which the built-in web server runs. By default this port is set to port 63342 through which JetBrains Rider accepts connections from services. You can set the port number to any other value starting with 1024 and higher.

Can accept external connections

If this checkbox is selected, then the files on the built-in server running on the specified port are accessible from another computer.
If this checkbox is cleared (by default), then the debugger listens only to local connections.

Allow unsigned requests

For security reasons, any request to a page on the built-in server from outside JetBrains Rider is by default rejected and the following authorization popup is displayed:
debugger_allow_unsigned_requests.png
To access the requested page, click Copy authorization URL to clipboard and paste the generated token in the address bar of the browser.

However this behavior may be annoying, for example, it may block your debugging session if manual intervention is impossible. To suppress displaying the authorization popup, select the Allow unsigned requests checkbox.

Last modified: 15 October 2019