CLion 2018.2 Help

Debugging

Start a debugging session

  1. Configure the Run/Debug Configurations profile (Run | Edit Configurations). For more information, see Configuring Debugger Options.

  2. Choose the desired CMake profile.
  3. Define a run/debug configuration for the application to be debugged.
  4. Create a breakpoint. To create a breakpoint, select the code line that you want to examine and click an area in the gutter near the line number.
  5. Click the Debug icon (icons actions startDebugger dark svg). Read more about debugging sessions in Starting the Debugger Session.

After you've started a debug session, the icons actions startDebugger svg icon that marks the Debug tool window toggles to debug active to indicate that the debug process is active.

Debug

After you have configured a run configuration for your project, you can launch it in debug mode by pressing Shift+F9.

In the Debug tool window you can see the list of frames and threads with their states, variables and watches. When you select a frame, you see the variables corresponding to the selected frame.

Breakpoints

Customize breakpoint settings

To customize breakpoint settings, press Ctrl+Shift+F8. To see all breakpoints in the project (with additional settings), click More or press the same shortcut Ctrl+Shift+F8 again.

cl breakpoint properties

Do not suspend code execution

Use action breakpoints to evaluate a variable at a particular line of code without suspending code execution. To create an action breakpoint, click the gutter while pressing Shift.

cl actionbp

Create a temporary breakpoint

To create a breakpoint that stops only once, click the left gutter while holding Shift+Alt. For more information, refer to the section Breakpoint types.

cl temp breakpoint

Disable breakpoints

To disable a breakpoint, click the breakpoint while pressing Alt. Refer to the section Enabling, Disabling and Removing Breakpoints for details.

Debugger session

Run to cursor

To stop code execution at the cursor position without adding another breakpoint, click the Run to cursor icon(icons actions runToCursor svg) or press Alt+F9.

cl runtocursor

The icon icons actions runToCursor svg is described in the toolbar reference of the Debug tool window.

Evaluate expression

While in debug mode, you can evaluate any expression by pressing Alt+F8.

cl evalexpr panelbutton

This tool provides code completion just as in the editor so it’s very easy to enter any expression:

cl evalexpression

Refer to the section Evaluating Expressions for details.

Remote debug

The final thing you definitely should know about debugging in CLion is Remote debug. Remote debug means attaching debugger to a process which is already running on a specific port on your or any other’s host. This way you can attach the debugger to your application server which is running standalone.

To create a remote configuration, go to Edit configurations and add a new GDB Remote Debug configuration. Make sure to specify the correct host and port before running this configuration.

Settings

Configuring debugger settings

To change debugger settings, click File | Settings. In the Settings menu, click Build, Execution, Deployment | Debugger.

Useful debugger shortcuts

ActionHotkey
Toggle breakpointCtrl+F8
Resume programF9
Step overF8
Step intoF7
StopCtrl+F2
View breakpoint details/all breakpointsCtrl+Shift+F8
Debug code at caretShift+F9 (within the main method), or Shift+Alt+F9
Last modified: 18 September 2018

See Also