1.在官方网站上下载ctags。
http://ctags.sourceforge.net/
2.进入目录,编译安装
which
ctags
./
configure
make
sudo make install
Exuberant Ctags就会被安装在/usr/local/目录下了,但是由于系统中原先已经内置了Ctags,
如果没有将/usr/local/bin添加到系统路径中的话,默认执行的是/usr/bin/ctags,可以在命令行中执行:
如果返回的不是/usr/local/bin/
ctags,那么就需要在~目录下的.profile文件中加入以下语句:
export PATH ="/usr/local/bin:/usr/local/sbin:$PATH "
然后命令行中执行:
source ~/ .profile
或者直接在~/.vimrc中加入以下配置语句:
let Tlist_Ctags_Cmd ="/usr/local/bin/ctags"
安装TAGLIST:
在官方网站上
下载Tag List然后解压,将plugin文件夹中的taglist.vim复制到~/.vim/plugin/ 中,
将doc文件夹中的taglist.txt复制到~/.vim/doc/中,如果~目录下没有对应的文件夹请自行创建。
注: windows用户需要把这个插件解压在你的$vim/vimfiles或$HOME/vimfiles目录。
要使用taglist plugin,必须满足:
- 打开vim的文件类型自动检测功能:filetype on
-
系统中装了Exuberant ctags
工具,并且taglist
plugin能够找到此工具(因为taglist需要调用它来生成tag文件) - 你的vim支持system()调用
使用下面的命令生成帮助标签(下面的操作在vim中进行):
:helptags ~/.vim/doc
生成帮助标签后,你就可以用下面的命令查看taglist的帮助了:
:help taglist.txt
Taglist提供了相当多的功能,我的vimrc中这样配置:
""""""""""""""""""""""""""""""
" Tag list (ctags)
""""""""""""""""""""""""""""""
if MySys() == "windows" "设定windows系统中ctags程序的位
let Tlist_Ctags_Cmd = 'ctags
elseif MySys() == "linux" "设定linux系统中ctags程序的位置
let Tlist_Ctags_Cmd = '/usr/bin/ctags'
endif
let Tlist_Show_One_File = 1 "不同时显示多个文件的tag,只显示当前文件的
let Tlist_Exit_OnlyWindow = 1 "如果taglist窗口是最后一个窗口,则退出vim
let Tlist_Use_Right_Window = 1 "在右侧窗口中显示taglist窗口
这样配置后,当你输入”:TlistOpen
“时,
显示如下窗口:
在屏幕右侧出现的就是taglist窗口,你从中可以看到在main.c文件中定义的所有tag:宏、定义、变量、函数等;你也可以双击某个tag,跳到
该tag定义的位置;你还可以把某一类的tag折叠起来(使用了vim的折行
功能),方便查看,就像上图中macro和variable那样。更多的功能,请查看taglist的帮
助页,本文也会介绍一些常用功能。
下面介绍常用的taglist配置选项,你可以根据自己的习惯进行配置:
- Tlist_Ctags_Cmd
选项用于指定你的
Exuberant ctags程序的位置,如果它没在你PATH变量所定义的路径中,需要使用此选项设置一下; -
如果你不想同时显示多个文件中的tag,设置Tlist_Show_One_File
为
1。缺省为显示多个文件中的tag;
-
设置Tlist_Sort_Type
为”name
“可以使taglist以tag名字进行排序,缺省是按tag在文
件中出现的顺序进行排序。按tag出现的范围(即所属的namespace或class)排序,已经加入taglist的TODO
List,但尚未支持; -
如果你在想taglist窗口是最后一个窗口时退出vim,设置Tlist_Exit_OnlyWindow
为
1; -
如果你想taglist窗口出现在右侧,设置Tlist_Use_Right_Window
为
1。缺省显示在左侧。 -
在gvim中,如果你想显示taglist菜单,设置Tlist_Show_Menu
为
1。你可以使用Tlist_Max_Submenu_Items
和Tlist_Max_Tag_Length
来控制菜单条目数和所显示tag名字的
长度; -
缺省情况下,在双击一个tag时,才会跳到该tag定义的位置,如果你想单击tag就跳转,设置Tlist_Use_SingleClick
为
1; -
如果你想在启动vim后,自动打开taglist窗口,设置Tlist_Auto_Open
为
1; -
如果你希望在选择了tag后自动关闭taglist窗口,设置Tlist_Close_On_Select
为
1; -
当同时显示多个文件中的tag时,设置Tlist_File_Fold_Auto_Close
为
1,可使taglist只显示当前文件tag,其它文件的tag都被折叠起来。 -
在使用:TlistToggle
打开taglist窗口
时,如果希望输入焦点在taglist窗口中,设置Tlist_GainFocus_On_ToggleOpen
为
1; -
如果希望taglist始终解析文件中的tag,不管taglist窗口有没有打开,设置Tlist_Process_File_Always
为
1; - Tlist_WinHeight
和Tlist_WinWidth
可以设置taglist窗口的高度和宽度。Tlist_Use_Horiz_Window
为1设置taglist窗口横向显
示;
在taglist窗口中,可以使用下面的快捷键:
<CR> 跳到光标下tag所定义的位置,用鼠标双击此tag功能也一样
o 在一个新打开的窗口中显示光标下tag
<Space> 显示光标下tag的原型定义
u 更新taglist窗口中的tag
s 更改排序方式,在按名字排序和按出现顺序排序间切换
x taglist窗口放大和缩小,方便查看较长的tag
+ 打开一个折叠,同zo
- 将tag折叠起来,同zc
* 打开所有的折叠,同zR
= 将所有tag折叠起来,同zM
[[ 跳到前一个文件
]] 跳到后一个文件
q 关闭taglist窗口
<F1> 显示帮助
可以用”:TlistOpen
“打开
taglist窗口,用”:TlistClose
“关闭
taglist窗口。或者使用”:TlistToggle
“在
打开和关闭间切换。在我的vimrc中定义了下面的映射,使用<F9>键就可以打开/关闭taglist窗口:
map <silent> <F9> :TlistToggle<cr>
Taglist插件还提供了很多命令,你甚至可以用这些命令创建一个taglist的会话,然后在下次进入vim时加载此会话。