How to navigate multiple ctags matches in Vim?

VimCtagsExuberant Ctags

Vim Problem Overview


I'm using Ctrl-] in Vim to navigate using Ctags. How do I navigate to alternate file if there are multiple matches?

Ex. something.publish in a codebase containing multiple occurrences of publish:

class Foo
  def publish
  end
end

class Bar
  def publish
  end
end

Vim Solutions


Solution 1 - Vim

Use g] instead of C-] to get the list of all matches.

You might want to read :help g]

Solution 2 - Vim

:tn[ext] goes to the next tag, :tp[revious] goes to the previous one. :ts[elect] gives you a list to choose from.

:help tag-matchlist for more fun and exciting things to try!

Solution 3 - Vim

Adding the answer I was ultimately looking for in case it helps others:

g<C-]> will jump to the tag if there's only one match and will present a list if there are multiple matches.

I've added this mapping to my .vimrc to make it do what I want by default:

nnoremap <C-]> g<C-]>

Solution 4 - Vim

ltag

ltag the_tag_name
lopen

opens a location window with the tag matches.

This is specially powerful with regular expression tag searches:

ltag /tag_na
lopen

which will list all tags that contain the string tag_na (thus including the_tag_name).

You can then further search inside the location list, before hitting enter to jump to the tag.

To use it for the word under the cursor, you might want to define the map:

nnoremap <leader>l exec("ltag ".expand("<cword>"))<CR>

Then, if you are a tab maniac like me:

command! -nargs=1 Ltag silent ltag <args> | execute "normal \<C-o>" | tab lopen

will open a new tab with the location list and all the matches, instead of jumping to the tab directly:

:Ltag /my_struct

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionSathishView Question on Stackoverflow
Solution 1 - VimDmitry FrankView Answer on Stackoverflow
Solution 2 - Vimdash-tom-bangView Answer on Stackoverflow
Solution 3 - VimRoss HambrickView Answer on Stackoverflow
Solution 4 - VimCiro Santilli Путлер Капут 六四事View Answer on Stackoverflow