How to navigate multiple ctags matches in Vim?

Question

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

Answer 1

: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!

Answer 2

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

You might want to read :help g]

Answer 3

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-]>

Answer 4

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