安装gutentag+ctags+gtags

在常规的使用ctags生成tag标签文件实现跳转的方式下,每次需要更新tags文件时都需要手工运行 ctags -R 生成当前项目所有源文件对应的tag标签文件。

当工程文件多、文件更新频繁时,上述生成tags文件的方法显得笨拙、低效

得益于 Vim 8 提供的异步机制,vim插件vim-gutentags能够自动异步生成 tags 文件,当检测到同一个工程下面的文件有修改时,gutentags能自动增量更新对应工程的 tags 文件,而不用全部重新生成tags文件,是一个非常高效的tags生成工具。

 

一、vim-gutentags 安装

1.1 软件依赖

vim-gutentags的本质仍然是使用ctags生成tag标签来实现函数跳转等功能,只是在ctags的基础上进行了封装和简化(具体封装方式在后文有简单分析),方便用户在vim中使用。

由于vim-gutentags依赖ctags工具,因此在使用vim-gutentags插件的系统中必须安装ctags软件,否则会报错"Excutable 'ctags' can't be found."。

ctags安装

mac下
brew tap universal-ctags/universal-ctags
brew install --HEAD universal-ctags

ubuntu下
apt-get install ctags

关于ctags的介绍,可以参考vim教程网上的文章Vim使用ctags实现函数跳转。

osx下gtags的回跳上一次是ctrl+t,进入定义是ctrl+]

其次,vim-gutentags需要在vim8.0以上版本才能正常工作,因为vim-gutentags实现的是增量更新tags的方式,依赖于vim8提供的异步机制

在低于vim8.0的版本是运行vim-gutentags插件,会报错"this plugin requires the job API from Vim8 or Neovim"。

关于vim8的编译和安装,可以参考vim教程网上的文章vim安装教程。

1.2 gutentags安装方法

本文介绍使用插件管理器vim-plug(安装HomeBrew以及解决Could not resolve host: raw.githubusercontent.com问题)安装vim-gutentags插件。vim-plug相比较Vundle,按需加载这点可以简化vim启动时间,而且Vundle已经三年没有更新。

在配置文件 ~/.vimrc 中增加配置项

Plugin 'ludovicchabant/vim-gutentags' 

后再在vim命令行模式下执行命令

 :PlugInstall 

即可完成vim-gutentags插件的安装。

1.3 另一个强大的搜索工具gtags

不用gtags前有如下几个问题:

1. 使用vimgrep有局限性,只能查找具体的文件,不能自动查找所有的子目录,而且不属于tags保存自动跳回上一次。

2. ctags查找函数的引用不方便。

安装完gtags(brew install global),ubuntu推荐源码安装

wget http://tamacom.com/global/global-6.6.2.tar.gz
tar xzvf global-6.6.2.tar.gz
cd global-6.6.2
./configure
make && make install

会自动安装gtags-cscope(一般不会用到,主要还是用Gtags)。

注意需要gtags-cscope.vim  gtags.vim放入~/.vim/plugin。

osx下gtags的回跳上一次是ctrl+shift+o,tab可以补全

主要命令如下:

01.Gtags func:查看定义处 02.Gtags -r func:查看引用处 03.Gtags -s text:查看未被数据库定义的tags

04.copen:打开quick fix显示窗口 05.cclose:关闭quick fix显示窗口 06.cn:下一项

07.cp:上一项 08.cl:列出查询到的相关项 09.ccN:到列表中第N个符号处

10.Gtags -g pattern:搜索pattern指定的字符串 11.Gtags -gie -pattern:-e选项可以用于搜索’-‘字符,但是基础搜索,没有元字符,-i选项忽略大小写,类似于grep的选项

12.GtagsCuorsor:取决于光标位置,要是在定义处,查询其引用,要是在引用处,跳转至其定义处,否则就是Gtags -s命令 13.Gtags -P text:查询包含text的路径名,Gtags -P后接/dir/为列出叫做dir目录下文件,后接\.h$列出所有的include文件

14.Gtags -f file:列出file里的符号,Gtags -f %则列出当前文件的符号

二、vim-gutentags配置介绍和原理分析

vim-gutentags插件的基本工作原理可以这么理解:首先确定vim当前打开的文件是否需要自动生成tags标签,若需要则通过某种方式确定tag文件的路径,再基于tag标签文件完成函数跳转、结构体定义跳转等功能。

因此,vim-gutentags需要确定是否需要生成tags标签文件,又需要告诉ctags软件自身生成的tags文件的具体路径信息 (因为从Vim使用ctags实现函数跳转一文已知,默认情况下,生成的tags文件必须在vim运行的当前目录才能在vim里面正确跳转)。

2.1 gutentags配置

为了提供上述信息给vim-gutentags,安装完gutentags后,需要在vim配置文件中增加以下必要的配置项。

" gutentags搜索工程目录的标志,碰到这些文件/目录名就停止向上一级目录递归 "
let g:gutentags_project_root = ['.tags']

" 所生成的数据文件的名称 "
let g:gutentags_ctags_tagfile = '.tags'

" 同时开启 ctags 和 gtags 支持:
let g:gutentags_modules = []
if executable('ctags')
    let g:gutentags_modules += ['ctags']
endif
if executable('gtags-cscope') && executable('gtags')
    let g:gutentags_modules += ['gtags_cscope']
endif
" 将自动生成的 tags 文件全部放入 ~/.cache/tags 目录中,避免污染工程目录 "
let s:vim_tags = expand('~/.cache/tags')
let g:gutentags_cache_dir = s:vim_tags
" 检测 ~/.cache/tags 不存在就新建 "
if !isdirectory(s:vim_tags)
   silent! call mkdir(s:vim_tags, 'p')
endif

" 配置 ctags 的参数,老的 Exuberant-ctags 不能有 --extra=+q,注意
let g:gutentags_ctags_extra_args = ['--fields=+niazS', '--extra=+q']
let g:gutentags_ctags_extra_args += ['--c++-kinds=+px']
let g:gutentags_ctags_extra_args += ['--c-kinds=+px']

" 如果使用 universal ctags 需要增加下面一行,老的 Exuberant-ctags 不能加下一行
let g:gutentags_ctags_extra_args += ['--output-format=e-ctags']

" 禁用 gutentags 自动加载 gtags 数据库的行为
let g:gutentags_auto_add_gtags_cscope = 0
  • 变量 gutentags_project_root 是vim-gutentags提供的用于搜索工程目录的标志,gutentags插件启动后,会从文件当前路径递归往上查找 gutentags_project_root 中指定的文件或目录名,直到第一次找到对应目标文件或目录名停止。若没有找到 gutentags_project_root 变量指定的文件或目录名,则gutentags不会生成tag文件。
  • 变量 gutentags_ctags_tagfile 和 gutentags_cache_dir 分别用于告诉ctags要使用的tag文件目录和tag文件名后缀,tag文件名的生成规则默认是根据生成tag文件的工程绝对路径按 - 分割而成
  • 变量 gutentags_ctags_extra_args 用于配置ctags生成tag标签的参数,具体参数含义可参考文章ctags参数介绍

以及修改plugin/gutentags.vim 去除.git配置

安装gutentag+ctags+gtags_第1张图片

所以,上面的gutentags配置指定了从当前路径向上递归查找是否有 .root、.svn、 .git、.project 等标志性文件来确定当前文档所属的工程目录;而ctags要使用的tag标签文件的路径为 ~/.cache/tags,文件后缀为 .tags

ctags 软件需要使用命令 :set tags+=tags文件路径 显式地指定tag文件路径,从文件 ~/plugged/vim-gutentags/autoload/gutentags/ctags.vim 可以看出,gutentags执行了命令 setlocal tags+= 来添加变量 gutentags_ctags_tagfile 指定的tag文件到局部 tags 搜索列表中。

安装gutentag+ctags+gtags_第2张图片

2.2 gutentags示例

安装了gutentags并且进行了上面的设置后,平时打开vim编辑文件基本感觉不到 tags 文件的生成过程了,只要文件修改过,gutentags 都在后台默默分析是否需要更新数据文件,还会帮你:setlocal tags+=... 添加到局部 tags 搜索列表中。得益于 Vim 8 的异步机制,你可以任意随时使用 ctags 相关功能,并且数据库都是最新的。

就像下面的vim视频教程一样,假设已经在vim配置文件中添加了上面的配置项,在当前目录新建文件 .project 后再打开当前目录下的任意文件,再退出vim后可以看到,gutentags已经为当前目录生成了tags文件 ~/.cache/tags/home-vim-vim.ink-libevent-.tags

安装gutentag+ctags+gtags_第3张图片

需要注意的是,gutentags 需要靠上面定义的 gutentags_project_root 判断文件所在的工程,如果一个文件没有保存在包含 .git.svn.root等 定义在 gutentags_project_root 中的文件,gutentags就不会为该文件生成 tags。

想要避免的话,你可以在你的野文件目录中放一个名字为 .root 的空白文件,主动告诉 gutentags 这里就是工程目录

2.3 基于gutentags实现跳转

在为当前目录生成tags文件后,可以通过按键 Ctrl + ] 跳转到对应的定义位置,再使用命令 Ctrl + o 回退到原来的位置。关于跳转的具体应用,可以参考Vim使用ctags实现函数跳转

 

注意:修改YouCompleteMe不进行语法分析,为了跟ctags配套使用自动补全。YouCompleteMe的安装请看https://blog.csdn.net/u012332571/article/details/38540987

安装gutentag+ctags+gtags_第4张图片

你可能感兴趣的:(operating,system)