1. 概述一般来说,在代码中跳转,离不开 ctags。
实际上,vim 中代码跳转是由 vim tags 模块完成的,tags 模块依赖于 tags 文件。
ctags(Generate tag files for source code) 是产生 tags 文件的。
tags 文件只包含了函数、类、变量的定义的信息,而没有包含使用信息。
如果要知道一个函数都在什么地方使用过,需要使用 cscope。
2. tags 文件的生成与更新ctags 默认是不会自动生成 ctags 文件的,常用的 3 个生成命令如下:
$ ctags *$ ctags -R$ ctags -R --c++-kinds=+p --fields=+iaS --extra=+q .
- -R: 循环生成子目录的 tags
- *: 当前目录下的所有文件,不递归
- –c++-kinds=+px : 记录 c++ 文件中的函数声明和各种外部和前向声明
- –fields=+iaS : ctags 要求描述的信息,其中i表示如果有继承,则标识出父类;a 表示如果元素是类成员的话,要标明其调用权限(即是 public 还是 private);S 表示如果是函数,则标识函数的 signature。
- –extra=+q: 强制要求ctags做如下操作—如果某个语法元素是类的一个成员,ctags默认会给其记录一行,可以要求ctags对同一个语法元素再记一行,这样可以保证在VIM中多个同名函数可以通过路径不同来区分。
3. 常见功能与快捷键详细的说明,见 vim 的 tags 帮助文档。
:help tags
命令、快捷键、功能描述如下:
- CTRL+] :tag tagname 跳转到定义处
- CTRL-W ] :stag tagname 新窗口中打开并跳转到定义处。split 后执行 tag tagname
- CTRL+T CTRL+] 的反操作,向回跳转。类似 CTRL+o,区别在于,CTRL+o 的跳转不局限于 CTRL+] 构成的调用树。
对于存在多个匹配的 tag(如, 在 .h 和 .cpp 中都声明或者定义的方法名):
- :ts[elect] 列出所有匹配的 tag
- :[count]tp[revious] 跳转至前 count 个 tag 处。
- :[count]tn[ext] 跳转至后 count 个 tag 处。
4. Vim + ctags 配置set tags=tags; " ; 不可省略,表示若当前目录中不存在tags, 则在父目录中寻找。map <C-F12> :!ctags -R --c++-kinds=+p --fields=+iaS --extra=+q .<CR>