vim插件taglist的安装和使用

1 简介

    a source code browser(supports C/C++, java, perl, python, tcl, sql, php, etc): 提供了源码的结构化浏览功能，可将源码中定义的类、函数、变量等以树结构显示，层次关系可一目了然，而且于快速定位并查看。

2 下载

    Official site：  http://vim-taglist.sourceforge.net/。
    VIM online：  http://www.vim.org/scripts/script.php?script_id=273。

3 安装

3.1 确保安装ctags    

    taglist基于ctags才能发挥作用，因此在使用taglist之前，确保已经安装了ctags。（ctags安装与配置：http://blog.csdn.net/clevercode/article/details/51366042）。

3.2 安装taglist插件

    # mkdir -p /usr/local/src/vim/plugin/taglist
    (上传taglist_46.zip 到 /usr/local/src/vim/plugin/taglist 目录)
    
    # unzip taglist_46.zip 
    
    # whereis vim
    
    拷贝插件
    # cp /usr/local/src/vim/plugin/taglist/plugin/taglist.vim /usr/share/vim/vim74/plugin/
    
    拷贝帮助文档
    # cp /usr/local/src/vim/plugin/taglist/doc/taglist.txt /usr/share/vim/vim74/doc/

4 配置

$ vim ~/.vimrc 


let Tlist_Show_One_File=1    "只显示当前文件的tags
let Tlist_WinWidth=40        "设置taglist宽度
let Tlist_Exit_OnlyWindow=1  "tagList窗口是最后一个窗口，则退出Vim
let Tlist_Use_Right_Window=1 "在Vim窗口右侧显示taglist窗口

5 使用

5.1 没有ctags工具报错

源码目录下并不需要生成tags文件。打开任何位置，任何php。只要安装了ctags工具。就可以使用taglist插件。

5.2 vim打开项目。

5.3 在vim中，打开taglist窗口使用

:Tlist

5.4 关闭窗口,再次输入:Tlist

5.5 taglist窗口中可使用的快捷键：

         跳到光标下tag所定义的位置，用鼠标双击此tag功能也一样（但要在vimrc文件中打开此项功能）

o                 在一个新打开的窗口中显示光标下tag

p 预览标记定义(仍然在taglist窗口)

     显示光标下tag的原型定义
u             更新taglist窗口中的tag
s             更改排序方式，在按名字排序和按出现顺序排序间切换
x             taglist窗口放大和缩小，方便查看较长的tag
+             打开一个折叠，同zo
-             将tag折叠起来，同zc
*             打开所有的折叠，同zR
=            将所有tag折叠起来，同zM
[[            跳到前一个文件
]]            跳到后一个文件
q            关闭taglist窗口
     显示帮助

5.6 其他一些设置选项可在vimrc脚本中添加

"设置ctags路径
let Tlist_Ctags_Cmd = '/usr/bin/ctags'


"启动vim后自动打开taglist窗口
let Tlist_Auto_Open = 1


"不同时显示多个文件的tag，仅显示一个
let Tlist_Show_One_File = 1


"taglist为最后一个窗口时，退出vim
let Tlist_Exit_OnlyWindow = 1


"taglist窗口显示在右侧，缺省为左侧
let Tlist_Use_Right_Window =1


"设置taglist窗口大小
"let Tlist_WinHeight = 100
let Tlist_WinWidth = 40


"设置taglist打开关闭的快捷键F8
noremap :TlistToggle


"更新ctags标签文件快捷键设置
noremap :!ctags -R