Ensure you have followed our guide on Preparing VS Code for Java.

Adding breakpoints

Purpose: A breakpoint is a line in the code at which the debugger will pause the execution.

How: Click in the left margin next to the line of code where you want to set the breakpoint. A red dot will appear in the margin.

[image credit: VS Code Docs]

• The Debugger for Java supports various breakpoints, including line breakpoints, conditional breakpoints, data breakpoints, and logpoints.
• Different types of breakpoints can be added by right-clicking in the left margin and selecting which type of breakpoint you want to add (line breakpoints, conditional breakpoints, and logpoints).

Running the code in Debug mode

Purpose: To get VS Code to run the code in the debugger mode, so that the debugger can direct the execution flow as needed by the debugging.

How: There are multiple ways to run and debug your Java application using the extension. One way is to click on the dropdown arrow beside the play icon (top editor title bar) and select Debug Java

• Alternatively, you can press F5
• By default, the debugger will run out-of-box by automatically finding the main class and generating a default launch configuration in memory to launch your application.

[image credit: VS Code Docs]

Examining the state of the suspended programme

Purpose: To examine values of variables at different steps of the execution

How: Use the Debug Console panel at the bottom of the window. At each breakpoint, you can see:

• Variables: All local variables and their current values.
• Watch: You can add specific expressions to observe.
• Call Stack: Shows the current stack of method calls.
• Breakpoints: Lists all active breakpoints.

[image credit: VS Code Docs]

Stepping through code

Purpose: To move through code line by line and observe how it is executed

How: Click the Step Over button (curved arrow) in the debug toolbar, or press F10

[image credit: VS Code Docs]

Stepping into a method

Purpose: To enter a method being called on the current line to see how it behaves

How: Click the Step Into button (down arrow), or press F11

[image credit: VS Code Docs]

Stepping out of a method

Purpose: To finish executing the current method and return to its caller, without stepping through the rest of it.

How: Click the Step Out button (up arrow), or press Shift+F11

[image credit: VS Code Docs]

Setting a Conditional Breakpoint

Purpose: To pause the execution at a certain breakpoint only when a certain condition is met (E.g. when i == 100)

How:

• Right-click in the editor margin and select "Edit Breakpoint"
• Choose the type of condition you want to set (expression, hit count, or wait for breakpoint)

[image credit: VS Code Docs]

Setting a Data Breakpoint

Purpose: To pause the execution at a certain breakpoint when a variable changes its value

How:

• First, run the application and break on a normal breakpoint
• Then pick a field in the VARIABLES view and set a data breakpoint

[image credit: VS Code Docs]

Setting a Logpoint

Purpose: To send output to the Debug Console without editing code, and without stopping execution flow

How:

• Right click in the editor margin and select "Add Logpoint"
• Enter the value that you want to be output in the Debug Console (e.g. the value of results.size() in a loop)

[image credit: VS Code Docs]

Evaluating Expressions

Purpose: Allows you to compute the value of an expression at a specific point during execution, enabling dynamic inspection of variables and data structures.

How: Enter through the WATCH window, or the Debug Console

Advanced Debugging Features

Hot-Code Replace

Purpose: Allows you to change and recompile code without restarting the debugging session, while paused at a breakpoint

Configuration Options

Purpose: You can configure the debugger using the options and settings. JVM arguments and environment variables is easily done with launch options.

Troubleshooting

If you encounter issues when using the VS Code debugger, refer to the detailed troubleshooting guide given here.