485
votes

I have just installed Ctags (to help with C++ development) with my Vim (or rather gVim), and would like to find out your favorite commands, macros, shortcuts, tips that go along with it...

Share your best arsenal. What other Vim add-ons you would recommend for C++ on Vim development?

EDIT What other add-on you would use in conjunction with Ctags?

EDIT2 What version of gVim you use with tags? Does it make a difference?

EDIT3 How do you enhance your programming experience for both big and small projects?

9
  • 15
    Make sure you're using exuberant ctags (a modern implementation) for best results: ctags.sourceforge.net
    – idbrii
    Commented Feb 23, 2011 at 18:59
  • 17
    Perhaps the kev is not constructive?
    – Floyd
    Commented Jun 6, 2013 at 11:29
  • 27
    though closed as not constructive almost two years ago, it is so constructive for me
    – sazary
    Commented Aug 10, 2013 at 22:01
  • 15
    I think the real reason for closing this question should have been: "This question, despite being enormously helpful, doesn't fit in StackOverflow policy of Q&A. Let this question and answers move to Quora and grow that site while we stubbornly keep closing helpful questions and answers".
    – Diego Pino
    Commented Feb 17, 2014 at 11:25
  • 2
    I understand why this question was closed, given the rules of SO. But flagging a >400 upvote question with a >300-upvote answer for deletion is a bit on the grumpy side, isn't it?
    – DevSolar
    Commented Aug 17, 2015 at 10:54

15 Answers 15

394
votes

Ctrl+] - go to definition
Ctrl+T - Jump back from the definition.
Ctrl+W Ctrl+] - Open the definition in a horizontal split

Add these lines in vimrc
map <C-\> :tab split<CR>:exec("tag ".expand("<cword>"))<CR>
map <A-]> :vsp <CR>:exec("tag ".expand("<cword>"))<CR>

Ctrl+\ - Open the definition in a new tab
Alt+] - Open the definition in a vertical split

After the tags are generated. You can use the following keys to tag into and tag out of functions:

Ctrl+Left MouseClick - Go to definition
Ctrl+Right MouseClick - Jump back from definition

12
  • 8
    C - ] => (control key) and ] key C - T => (control key) and T key Just for newbies to ctags. Thanks for new tab trick
    – kumar
    Commented Dec 8, 2009 at 10:52
  • 6
    Similarly, after splitting the window with Ctrl-w C-] you can do C-w T (aka Shift-t) to change that split into a new tab. Commented Sep 29, 2010 at 17:25
  • 1
    @Will If you are using vim from the terminal then you have to change the terminal preferences to make option key behave like an alt key. If you are using MacVim then add this line to vimrc 'set macmeta'. There is doc for macmeta, :h macmeta.
    – Amjith
    Commented Jan 31, 2012 at 13:31
  • 17
    g C-] is very useful. It opens a quick dialog to select one between multiple definitions. Commented Mar 22, 2012 at 10:23
  • 3
    g] is also useful. You can position the cursor over the tag name and press g] to get a list of matching tags.
    – zeekvfu
    Commented Aug 23, 2013 at 9:23
176
votes

One line that always goes in my .vimrc:

set tags=./tags;/

This will look in the current directory for "tags", and work up the tree towards root until one is found. IOW, you can be anywhere in your source tree instead of just the root of it.

7
  • 37
    Going up to root is excessive. I suggest only going up to home instead: tags+=tags;$HOME
    – gotgenes
    Commented May 12, 2009 at 6:03
  • 37
    The source trees I work on aren't always in my home directory... and being that $HOME tends to be two directories away from root... well, I can afford two more directory lookups. :)
    – uzi
    Commented May 13, 2009 at 19:50
  • 6
    I agree w/ uzi. If my cwd is /home/me/programming/foo/bar/baz/bang/bam that's only 8 directory lookups. I suppose it depends on your tolerance for speed, but the time to lookup 1 directory isn't noticeably different from 8 on my machine. Commented Oct 23, 2009 at 15:04
  • 1
    It does depend on your scenario, I need to use gotgenes suggestion on one of my machines because there are roughly 8,000 directories in /home, and that tends to be a bit sluggish.
    – jkerian
    Commented Feb 22, 2011 at 15:50
  • 1
    Is there something similar for cscope?
    – szx
    Commented Dec 7, 2012 at 11:19
45
votes

Another useful plugin for C development is cscope Just as Ctags lets you jump to definitions, Cscope jumps to the calling functions.

If you have cscope in your ~/bin/ directory, add the following to your .vimrc and use g^] to go to the calling function (see :help cscope).

if has("cscope")
    set csprg=~/bin/cscope
    set csto=0
    set cst
    set nocsverb
    " add any database in current directory
    if filereadable("cscope.out")
        cs add cscope.out
        " else add database pointed to by environment
    elseif $CSCOPE_DB != ""
        cs add $CSCOPE_DB
    endif
endif

Almost forgot... Just as ctags - you have to generate (and periodically update) the database. I use the following script

select_files > cscope.files
ctags -L cscope.files
ctags -e -L cscope.files
cscope -ub -i cscope.files

Where 'select_files' is another script that extracts the list of C and header files from the Makefile. This way I index only the files actually used by the project.

8
  • What is the advantage of cscope over ctags? Do they compliment eachother?
    – Whaledawg
    Commented Feb 20, 2009 at 4:53
  • 4
    They complement each other. Ctags finds the definition of a symbol or a function. Cscope can find all the places calling a function. using both of them makes navigation in large source trees very easy.
    – nimrodm
    Commented Feb 20, 2009 at 7:51
  • 1
    However, AFAIK cscope has a limited comprehension of C++. Commented Feb 21, 2009 at 11:35
  • It is limited, and not very good. But for what it does (jumping to USAGES), there isn't any better alternative. Its main problem is that when you want to jump to function calls (f), you often need to jump to anywhere that symbol is used (s) instead and filter the results mentally... Commented Apr 13, 2009 at 13:17
  • 2
    @Whaledawg Yes, when I press CTRL+] my sound card sends "clap.wav" in output :) Commented Feb 2, 2011 at 14:14
27
votes

You can add directories to your ctags lookup. For example, I have a ctags index built for Qt4, and have this in my .vimrc:

set tags+=/usr/local/share/ctags/qt4
23
votes

All of the above and...

code_complete : function parameter complete, code snippets, and much more.

taglist.vim : Source code browser (supports C/C++, java, perl, python, tcl, sql, php, etc)

1
  • 5
    I think it would be good to add that taglist.vim is the most downloaded vim plugin.
    – amit kumar
    Commented Nov 28, 2009 at 16:09
16
votes

I use ALT-left and ALT-right to pop/push from/to the tag stack.

" Alt-right/left to navigate forward/backward in the tags stack
map <M-Left> <C-T>
map <M-Right> <C-]>

If you use hjkl for movement you can map <M-h> and <M-l> instead.

5
  • isn't the same as ctrl -] and ctrl-t -- I guess, your suggestion is a bit cleaner.
    – Sasha
    Commented Feb 19, 2009 at 1:47
  • @Sasha, Pardon? Don't know what you're saying. =X To note, this also works in :help.
    – strager
    Commented Feb 19, 2009 at 1:48
  • 2
    I think this is more intuitive and cleaner than the default.
    – Ayman
    Commented Sep 10, 2009 at 7:56
  • 1
    @Ayman But also violates the principle of not having to move the hands off the homerow, like using hjkl vs the arrow keys. Commented Aug 29, 2013 at 22:38
  • @TankorSmash, what principle?
    – strager
    Commented Aug 30, 2013 at 5:07
10
votes

Several definitions of the same name

<C-w>g<C-]> open the definition in a split, but also do :tjump which either goes to the definition or, if there are several definitions, presents you with a list of definitions to choose from.

5
  • 2
    Similar to the first command, vim has a :ptag command that opens the definition in a preview window.
    – idbrii
    Commented Nov 24, 2011 at 17:24
  • 1
    The preview window is nice because you can close it with :pc from any other window, without having to first move the cursor to the preview window. Commented Mar 22, 2012 at 13:59
  • There's also a neat autocmd trick with ptag at :h CursorHold-example which displays the tag for the item under the cursor in the preview window after a configurable timeout. Commented May 28, 2013 at 0:11
  • +1 for :tjump i've now bound :tjump <C-r><C-w><CR> works better than <C-]> imho Would love to combine this behaviour with :ptag Commented Jun 17, 2013 at 10:38
  • :help is awesome sometimes... see :help CTRL-W_g} and :ptjump Commented Jun 17, 2013 at 11:19
8
votes

The command I am using most is C-] which jumps to the definition of the function under the cursor. You can use it more often to follow more calls. After that, C-o will bring you back one level, C-i goes deeper again.

1
  • 16
    C-t goes back one level in the C-] stack, while C-o goes back to a previous cursor position after a movement. So if you C-] to a function then page down, C-t will go back immediately while C-o will go back to the start of the function, then back to the call. Commented Feb 19, 2009 at 2:21
6
votes

I've found the taglist plug-in a must-have. It lists all tags that it knows about (files that you have opened) in a seperate window and makes it very easy to navigate larger files.

I use it mostly for Python development, but it can only be better for C/C++.

5
votes

I've encapsulated tags manipulation in an experimental plugin of mine.

Regarding C++ development in vim, I've already answered there: I use my own suite, and a few other plugins.

5
votes

I've been adapting my vim plugins for two years to support big enough c++ project. You can take a look at them.

They use ctags and cscsope.

http://www.vim.org/scripts/script.php?script_id=1638
http://www.vim.org/scripts/script.php?script_id=2507

4
votes

I put the following in my .gvimrc file, which searches up the tree from any point for a tags file when gvim starts:

function SetTags()
    let curdir = getcwd()

    while !filereadable("tags") && getcwd() != "/"
        cd ..
    endwhile

    if filereadable("tags")
        execute "set tags=" . getcwd() . "/tags"
    endif

    execute "cd " . curdir
endfunction

call SetTags()

I then periodically regenerate a tags file at the top of my source tree with a script that looks like:

#!/bin/bash

find . -regex ".*\.\(c\|h\|hpp\|cc\|cpp\)" -print | ctags --totals --recurse --extra="+qf" --fields="+i" -L -
1
2
votes

I use vim in macos, and the original ctags doesn't work well, so I download newest and configure make make install it. I install ctgas in /usr/local/bin/ctags(to keep original one)

"taglist
let Tlist_Ctags_Cmd = "/usr/local/bin/ctags"
let Tlist_WinWidth = 50
map <leader>ta :TlistToggle<cr>
map <leader>bta :!/usr/local/bin/ctags -R .<CR>
set tags=tags;/
map <M-j> <C-]>
map <M-k> <C-T>
1
vote

I adapted the SetTags() search function above (which should be replaced by the equivalent set tags+=./tags;/) to work for cscope. Seems to work!

"cscope file-searching alternative
function SetCscope()
    let curdir = getcwd()

    while !filereadable("cscope.out") && getcwd() != "/"
            cd ..
                endwhile

    if filereadable("cscope.out")
            execute "cs add " . getcwd() . "/cscope.out"
                endif

    execute "cd " . curdir
    endfunction

call SetCscope()
1
  • 3
    As gotgenes said, You just re-invented upward search. See :h file-searching. See this plugin for a relevant example.
    – idbrii
    Commented Nov 24, 2011 at 17:25
1
vote

Another iteration on the SetCscope() function above. That sets cscope pre-path to get matches without being on the dir where "cscope.out" is:

function s:FindFile(file)
    let curdir = getcwd()
    let found = curdir
    while !filereadable(a:file) && found != "/"
        cd ..
        let found = getcwd()
    endwhile
    execute "cd " . curdir
    return found
endfunction

if has('cscope')    
    let $CSCOPE_DIR=s:FindFile("cscope.out")
    let $CSCOPE_DB=$CSCOPE_DIR."/cscope.out"
    if filereadable($CSCOPE_DB)
        cscope add $CSCOPE_DB $CSCOPE_DIR
    endif

    command -nargs=0 Cscope !cscope -ub -R &
endif
1
  • 3
    As gotgenes said, You just re-invented upward search. See :h file-searching. See this plugin for a relevant example.
    – idbrii
    Commented Nov 24, 2011 at 17:30