VIM学习笔记 标签选项(Tag Option)

标签选项

通过'tags'选项,可以指定查找标签文件的位置。根据以下默认设置,Vim将在当前目录查找标签文件:

set tags=tags=./tags,tags

对于大量的代码文件,也可以设置更精细的查找路径:[S]

set tags=./.tags;,.tags

其中,以逗号分隔的参数为:

假设我们针对rails源码库(~/src/rails)生成tags文件,并在'tags'选项中包含此文件,那么就可以在编写代码时,方便地跳转至标签的定义处,获得相关地使用说明。

set tags+=~/tags/rails.tags

默认设置下,Vim使用二分法(binary search)来查找指定的标签名。如果您生成的标签文件(Tags File)没有经过排序,那么可以切换至线性查找(linear search)方式:

:set notagbsearch

标签函数

通过调用Vim内置的taglist函数,可以实现自定义的标签匹配功能。taglist函数将根据输入的正则表达式,将所有匹配的标签以列表形式返回。使用:help taglist命令,可以查看该函数的帮助信息。

例如以下代码,利用taglist函数实现了查找指定函数的功能:

command! -nargs=1 TagFunction call s:TagFunction(<f-args>)
function! s:TagFunction(name)
  " Retrieve tags of the 'f' kind
  let tags = taglist('^'.a:name)
  let tags = filter(tags, 'v:val["kind"] == "f"')

  " Prepare them for inserting in the quickfix window
  let qf_taglist = []
  for entry in tags
    call add(qf_taglist, {
          \ 'pattern':  entry['cmd'],
          \ 'filename': entry['filename'],
          \ })
  endfor

  " Place the tags in the quickfix window, if possible
  if len(qf_taglist) > 0
    call setqflist(qf_taglist)
    copen
  else
    echo "No tags found for ".a:name
  endif
endfunction

使用:TagFunction HTML命令调用自定义函数,将查找所有以“HTML”开头的函数,并显示在Quickfix中。

taglist_Quickfix

标签相关插件

unimpaired.vim插件,映射了一系列方括号开头的快捷键,以方便在标签之间进行跳转。比如]t代表:tnext[t代表:tprev等等。

vim-gutentags插件,可以检测文件变动并自动增量更新标签文件(Tags File)。它可以异步更新标签,并且对于标签文件进行排序,以便于Vim使用二分法快速搜索关键字。

Ver: 2.0 | YYQ<上一篇 | 目录 下一篇>