Debugging C++ Programs in Vim

Timothy Karani
Nov 23, 2020 · 5 min read
Image for post
Image for post

Vim can work with GDB to debug C++ programs. This feature works in Vim version 8.1+. In this blog post, we’ll go through debugging C++ in Vim.

Setting Things Up

You need to load the plugin using the command:

:packadd termdebug

You have to do this every time you want to debug. If you want this to happen automatically, add the command to your .vimrc.

In .vimrc:

packadd termdebug

The code below is for the sample program that we are going to debug. Open vim and type it. We are going to save it as hello.cpp

in hello.cpp:

We are going to compile the program using g++:
in your terminal:

The -g flag tells g++ to produce debugging information that gdb can work with.


Assuming you still have the program open in vim, we can start debugging by either of these two ways:

Variant 1

Termdebug accepts the program name as the argument. In our case, we compiled hello.cpp to hello.

:Termdebug hello

Variant 2

The argument is optional so you can still start the debugging environment by just typing:


In this case, however, we have to explicitly make GDB know the file/program we are going to debug:
in the GDB window inside of vim:

(gdb) file hello

Once you have started Termdebug, you can run it in either of the two following ways:

  • Through a Vim command :Run
  • In the GDB window:
(gdb) run

Here is a screenshot of my Vim environment at this stage:

Image for post
Image for post

The top window in the image above is for interacting with gdb. The middle window shows the output from our program when run. The bottom window is the editor window and as you can see, our code is displayed there. The buttons on top of this window ( Step, Next, Finish, etcetera) are clickable.

The arrangement of windows above isn’t my favourite, to make yours look like mine does below, add the following to your .vimrc:

When you close vim and open it again then run Termdebug, it will look like:

Image for post
Image for post

Now let’s see how to quit:

Quit Debugging

To quit debugging, type the quit command in the gdb window:
in the GDB window:

(gdb) quit

Debugging Session

Let us now modify our program a little bit to look like this:

The program now checks if there is a command-line argument and if there is one it prints it out. Compile it. You can do this from vim using !:

Load the program:

Command-Line Arguments

By seeing argc and argv you already know that this program accepts command line arguments, ideally one, for this program. It could be any arbitrary text. To pass the command line arguments, we could do either of the two:

  • Through Vim’s :Arguments command.
:Arguments world
  • In the future should you want to pass multiple arguments to another program, you could still do something like:
:Arguments -d hello -n 8 — some-arg world
  • Through gdb. This can be done using set args
(gdb) set args world
  • In the future if you wanted to run some program that accepts several command-line arguments, you could:
(gdb) set args -d hello -n 8 — some-arg world

Setting and Clearing Breakpoints

Now that the program is loaded, you can set breakpoints either in the editor or in the gdb window:

In the Editor Window

Move the cursor to the line you want to set the breakpoint, then enter the :Break command. In our sample program, we can navigate to line 15 then run :Break. To clear a breakpoint, navigate the cursor to the line with the breakpoint then run:Clear.

In the gdb window

The normal gdb commands still work:

  • Set a breakpoint:
(gdb) break hello.cpp:15


(gdb) break 15
  • Deleting a breakpoint: Note that when you set a breakpoint, the line number is preceded with a number indicating the breakpoint number. Since the breakpoint in line 15is the first breakpoint we have set in this program, we can delete the breakpoint using the delete or delcommand that accepts as an argument the breakpoint number, passing the number 1.
(gdb) del 1

In both cases, after setting a breakpoint you’ll get an indication that the breakpoint has been set by seeing the breakpoint number, in our case 1 in line 15 in the editor window. Set other breakpoints in lines 22 and 25. Your window should now look like:

Image for post
Image for post

Run the Program

Let us now run the program. This can be done:

  • Through Vim’s :Runor
  • Through gdb
(gdb) run

The program execution will halt at line 15.

Values of variables

  • In the editor window: You can check the value of variables by moving the cursor to them then running :Evaluate.
    Evaluate by default shows the value of the variable under the cursor. This can also be achieved by pressing the key K while the cursor is over the variable.
    You can also pass as an argument the name of the variable whose value you want to see, for example:Evaluate age.
  • In gdb's window, you can also check the value of the variable using the print or p command.
(gdb) print name
(gdb) p age

Quick Tip

While checking the value of a variable, you can see <optimized out> as its value. Most compilers do optimizations that result in the value of the variable not being seen in the debugger. If you want to see the value of the variable, you have to add the volatile specifier to it and then recompile the entire program again. For example:


Let us now continue with our program execution. To do this, you can:

  1. Click on the Cont button on top of the editor window or
  2. Run the :Continue command in vim's last-line mode or
  3. Run continue or c in gdb:
(gdb) c

Now have fun as you explore the program further.

Resources for Further Exploration

Originally published at

The Startup

Medium's largest active publication, followed by +773K people. Follow to join our community.

Timothy Karani

Written by

Just another coder who loves music, game, and coffee.

The Startup

Medium's largest active publication, followed by +773K people. Follow to join our community.

Timothy Karani

Written by

Just another coder who loves music, game, and coffee.

The Startup

Medium's largest active publication, followed by +773K people. Follow to join our community.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store