[转]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/

 

    完成了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以后我么就可以进行察看了，具体步骤见如下截图

 

 

输入TlistToggle来打开侧面窗口

 

使用ctr 和两次w在侧窗口和主窗口之间进行切换

 

移动到土体的函数后，按enter键察看具体函数。

 

      有时我们想察看的函数在其他代码文件中定义，这是我们只要将光标定位到想察看的函数上，然后按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为１；

- 如果你想taglist窗口出现在右侧，设置Tlist_Use_Right_Window为１。缺省显示在左侧。

- 在gvim中，如果你想显示taglist菜单，设置Tlist_Show_Menu为１。你可以使用Tlist_Max_Submenu_Items和Tlist_Max_Tag_Length来控制菜单条目数和所显示tag名字的长度；

- 缺省情况下，在双击一个tag时，才会跳到该tag定义的位置，如果你想单击tag就跳转，设置Tlist_Use_SingleClick为１；

- 如果你想在启动VIM后，自动打开taglist窗口，设置Tlist_Auto_Open为1；

- 如果你希望在选择了tag后自动关闭taglist窗口，设置Tlist_Close_On_Select为1；

- 当同时显示多个文件中的tag时，设置Tlist_File_Fold_Auto_Close为１，可使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为１设置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/，也添加了自己在使用过程中遇到的问题及解决方法，最后添加了一些常用设置