adm1989

导航

[转]Vim+Taglist+Ctags

  很多linux软件开发实际上并不实在X window的情况下进行的,这时我们不可能启动基于X window的图形化窗口,在这一情况下我们所能使用的主要的编辑器是vim和emacs.(ps:emacs和vim虽然被称为两大编辑器之神,但是个 人感觉vim的功能键设置的比较好用)下面详细介绍一下vim的配置使用。对于vim环境本身的设置可以google。下面主要是说明插件的配置。
 
ctags
    首先是ctags的安装,推荐使用exuberant ctags,我们可以从其官方网站上下载它的源码包,进行解压缩,编译,安装即可。
    具体过程如下:
        cd 到解压后文件的路径
            //在编译前执行configure可执行文件,configure程序将检测系统配置情况
        ./configure
            //完成配置以后会得到一个配置文件,用于make编译时使用
            //接下来使用make开始编译源代码
        make
            ps:解析来的命令我们要使用到root权限,注意切换
            //编译后我们使用ctags自带的创建目录命令来创建ctags的安装目录
        ./makeinstalldirs
            //最后使用make install来进行安装
        make install

    在编译的过程中可能会遇到“bash . /configure permission denied”等问题,那为什么会出现这个问题呢?那是因为那个configure文件非可执行文件的原因,当你在当前目录下执行
    $ chmod +x ./configure
        即为当前目录下的configure文件添加可执行性之后你就可以通过直接
    $ ./configure
        的方式来安装了。也就是说解决这个错误的办法是先执行
    $ chmod +x ./configure
        亦或者你加个“bash”即:
    $ bash ./configure

    

    至此,ctags的安装已经完成,可以使用ctags命令来检测时候完成安装。
    which ctags
        //确认ctags是否安装成功,如果安装好该指令的执行结果为:/usr/local/bin/ctags
    PS:其实exuberant ctags的安装可以直接在命令行下安装,貌似ubuntu 12.04中提供的版本为5.9,而其官方网站上提供的最高版本为5.8,版本问题可能影响到具体的使用。
 
taglist
    下面我们来进行taglist的安装,同ctags的安装一样这里我们也是去其官方网站下载解压其源码包。具体步骤如下:
    我们首先在家目录下创建.vim文件(mkdir .vim)   以便于存放vim的插件。
    然后把我们下载到的taglist源码包进行解压,把其中的doc和plugins目录拷贝到.vim文件夹下。
进入到vim在命令模式下输入helptaglist~/.vim/doc即完成了taglist的安装。在vim中输入Tlist,如果出现如下画面则证明安装成功。

    也可以用如下指令,直接在Vim的安装路径进行配置:
    sudo cp taglist/doc/taglist.txt /usr/share/vim/vim73/doc/
    sudo mkdir /usr/share/vim/vim73/plugin/
    sudo cp taglist/plugin/taglist.vim  /usr/share/vim/vim73/plugin/
 
ubuntu下vim编辑器vim+taglist+ctags的配置 - Search - Search的博客
    完成了taglist和ctags的安装,但是这时ctags和taglist还没有联系起来。为此,我们需要修改~/.vim/plugin /taglist.vim文件,找到if !exitsts(loaded_taglist)这一行,并在其前面添加let Tlist_Ctags_Cmd="/usr/local/bin/ctags"
ps:在这里需要注意的是我们在设置直线需要察看我们ctags可执行可执行路径到底是在哪里,我们可以进入到上述目录,一直找到具体的可执行的文件ctags,并将其路径赋给Tlist_Ctags_Cmd(例如我的路径是/usr/local/bin/ctags/ctags
 
vim+taglist+ctags阅读代码
    为了使用vim+taglist+ctags来阅读代码,我们首先必须生成函数和变量的符号信息。这一步我们使用ctags完成。
    例如我们使用我们刚才下载的ctags的源码包为例。
    //生成tag
        执行 ctags -R(-R递归作用)
    //检查是否生成了tags
        ls -l tags
    生成tag以后我么就可以进行察看了,具体步骤见如下截图
ubuntu下vim编辑器vim+taglist+ctags的配置 - Search - Search的博客
 
 
输入TlistToggle来打开侧面窗口
ubuntu下vim编辑器vim+taglist+ctags的配置 - Search - Search的博客
 
使用ctr 和两次w在侧窗口和主窗口之间进行切换
ubuntu下vim编辑器vim+taglist+ctags的配置 - Search - Search的博客
 
移动到土体的函数后,按enter键察看具体函数。
ubuntu下vim编辑器vim+taglist+ctags的配置 - Search - Search的博客
 
     有时我们想察看的函数在其他代码文件中定义,这是我们只要将光标定位到想察看的函数上,然后按ctr+]键就可以进行察看了,按ctr+O可以跳回到源文件中。

下面介绍常用的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_ItemsTlist_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_WinHeightTlist_WinWidth可以设置taglist窗口的高度和宽度。Tlist_Use_Horiz_Window为1设置taglist窗口横向显示;

配置

使用sudo vim /etc/vim/vimrc 编辑vim的配置文档,在其中加入如下命令:
"""""""""""""""""Taglist设置"""""""""""""""""
""let Tlist_Auto_Open = 1
let Tlist_Ctags_Cmd = '/usr/bin/ctags'
let Tlist_Show_One_File = 1
let Tlist_Exit_OnlyWindow = 1

使用

    在Vim中加载代码文件后,可以使用以下命令控制taglist

TlistOpen(直接Tlist也可)打开并将输入焦点至于标签列表窗口,效果如上图所示
TlistClose关闭标签列表窗口
TlistToggle切换标签列表窗口状态(打开←→关闭),标签列表窗口是否获得焦点取决于其他配置
ctl-w+w或ctl-w+ 方向键窗口切换(taglist本质上是一个vim分隔窗口,因此可以使用ctl-w系列快捷键对窗口进行切换操作)在Taglist窗口主要有以下操作
按F1:打开帮助回车键:跳到光标所在的标记的定义处(如将光标移到main函数,按回车键)
o:新建一个窗口,跳到标记定义处
p:预览标记定义(仍然在taglist窗口)
空格:显示标记的原型(如函数原型)
u:更新标记列表(比如源文件新增了一个函数,并在保存后,可在taglist窗口按u)
s:选择排序字段(暂时我也不知道什么意思)
d:删除光标所在的taglist文件(如用vi打开了两个文件f1.c,f2.c可以删除f1.c的标记)
x:n放大/缩小taglist窗口
+:展开(指标记)
-:折叠
*:全部展开
=:全部折叠
[[:将光标移到前一个文件的起点
]]:将光标移到后一个文件的起点
q:退出taglist窗口
F1:关闭帮助
 
转自:http://xiangyanglai.blog.163.com/blog/static/2047252022012330111618740/,也添加了自己在使用过程中遇到的问题及解决方法,最后添加了一些常用设置

posted on 2013-04-09 18:19  adm1989  阅读(805)  评论(0编辑  收藏  举报