vim taglist插件的使用

节选自： http://hi.baidu.com/liupc/blog/item/53ff336d0d307dfa431694ba.html

 

下面介绍常用的 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 窗口横向显示；

在 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 中定义了下面的映射，使用 “,tl” 键就可以打开 / 关闭 taglist 窗口：

 

map <silent> <leader>tl :TlistToogle<cr>

 

Taglist 插件还提供了很多Ex命令，你甚至可以用这些命令创建一个 taglist 的会话，然后在下次进入 VIM 时加载此会话。