Skip to content
This repository

Integrate your debugger with Vim. Currently supports Perl, Python, and Ruby. This code is very much in beta.


    * Improved handling of key bindings
    * Added ability to "step out" or return from a subroutine
    * Added a Gvim menu
    * Bug fixes
latest commit c7e3af9b54
Eric Johnson authored
Octocat-spinner-32 bin A minor simplification. May 09, 2013
Octocat-spinner-32 documentation Have a better script to try out VimDebug. May 11, 2013
Octocat-spinner-32 lib Have a gvim menu for VimDebug. May 23, 2013
Octocat-spinner-32 script Improve our developer minimal Vim launcher. May 23, 2013
Octocat-spinner-32 t Have a gvim menu for VimDebug. May 23, 2013
Octocat-spinner-32 .gitignore Don't track the Vim help tags file. May 20, 2013
Octocat-spinner-32 Changes Updated Changes file for v0.904 May 25, 2013
Octocat-spinner-32 META.json v0.904 May 25, 2013
Octocat-spinner-32 README.pod v0.904 May 25, 2013
Octocat-spinner-32 dist.ini Fix dist.ini to pick up a few prerequisites. May 16, 2013


Vim::Debug::Manual - Integrate the Perl debugger with Vim

What is VimDebug?

VimDebug integrates the Perl debugger with Vim, allowing developers to visually step through their code, examine variables, set or clear breakpoints, etc.

VimDebug is known to work under Unix/Ubuntu/OSX. It requires Perl 5.FIXME or later and some CPAN modules may need to be installed. It also requires Vim 7.FIXME or later that was built with the +signs and +perl extensions.

How do I install VimDebug?

VimDebug has a Perl component and a Vim component. The Vim component happens to be supplied with the Perl component.

The Perl component, Vim::Debug, can be obtained from CPAN. A simple way to install it is to use cpanminus's cpanm program. First, install cpanminus:

    curl -L | perl - --sudo App::cpanminus

Then, install VimDebug's Perl files:

    cpanm Vim::Debug

To install the Vim component, execute the following program, which was installed with the Perl component:

    vimdebug-install -d ~/.vim

You may want to replace ~/.vim by some other directory that your Vim recognizes as a runtimepath directory. See Vim's :help 'runtimepath' for more information.

Finally, launch Vim and install and read the Vim help file, which describes how to use VimDebug:

    :helptags ~/.vim/doc
    :help VimDebug

Make sure that the directory where that doc directory resides is in your Vim runtimepath, else Vim won't find its help information even if it manages to build the help index.

Improving VimDebug

VimDebug is on github:

To do development work on VimDebug, clone its git repo and read ./documentation/DEVELOPER.

In principle, the VimDebug code can be extended to handle other debuggers, like the one for Ruby or Python, but that remains to be done.

Please note that this code is in beta.


Eric Johnson <kablamo at iijo dot nospamthanks dot org>


This software is copyright (c) 2013 by Eric Johnson.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

Something went wrong with that request. Please try again.