lookupfile.vim插件详解
lookupfile.vim是Vim的一个五星级的插件，它允许用户只输入部分文件名甚 至使用正 则表达式快速查找并打开目标文件，尤其对于程序员来说，lookupfile的作用绝对称得上“Life changing”。
lookupfile支持多种查找方式，大体分为三种，即在Buffer中查找、在指定路径下查找和在Tags文件中查找。其中，最使 lookupfile熠熠生辉的就是根据Tag文件查找和打开文件。
假设现有一个包含数百个源码文件的工程，首先使用某种手段或工具生成Vim兼容的Tags文件（稍后详述），然后打开Vim并使 lookupfile使用此Tags文件作为查找源。此后即可使用“:LookupFile”命令打开一个输入窗口， 输入部分文件名或一个正则表达式，则所有匹配项会显示在一个下拉列表中，最后选中任意匹配项即可快速打开该文件：
这种方式使Vim从浩如烟海的源码中查找和打开文件变得易如反掌，它意味着你不必再把时间浪费在NERDTree或 者简单的“:set wildmenu”+“:cd”，甚至邪恶的 “Windows Explorer”上；也不必再来回地切换窗口，甚至手都不需要离开键盘就把这一切搞定了。
lookupfile的安装方法如下：
- 下载lookupfile和genutils， 后者是lookupfile依赖的一个通用函数库。
- 解压这两个压缩包，并将得到的多个文件夹覆盖到Vim的运行时环境下，如Linux下为“~/.vim”，Windows下可为Vim安装目录下 的“vimfiles”目录。
- 进入Vim运行时环境下的“doc”目录，用Vim打开任一文件，输入命令“:helptags .”并回 车。
至此，lookupfile的安装已经完成。但要使用它提升工作效率，还需要做些额外的工作，毕竟你总不能每次都要到工程根目录下手动生成Tags 文件，再“:let g:LookupFile_TagExpr='"./filenametags"'”，然后每次 找文件的候还要“:LookupFile”！
首先就是Tags文件的生成，对于Linux用户，这个可以使用Shell脚本实现：
-
#!/bin/sh
-
# generate tag file for lookupfile plugin
-
echo -e "!_TAG_FILE_SORTED\t2\t/2=foldcase/" > filenametags
-
find . -not -regex '.*\.\(png\|gif\)' ! -path "*svn*" -type f -printf "%f\t%p\t1\n" | sort -f >> filenametags
将此段Shell命令保存成名为“genfiletags”的文件并设置权限为“755”， 然后将“genfiletags”复制到环境变量“PATH”下的一个目录中（目 的是允许直接执行“genfiletags”而无须输入该文件的完整路径）。以后只需在工程根目录下执行“genfiletags”， 即可在该目录下生成名为“filenametags”的Tags文件。
而对于Windows用户，事情开始变得邪恶起来，批处理显 然很难胜任这在Linux下只需两行命令就轻松搞定的工作，所幸我安装了Cygwin并将其安装目录下的“bin” 目录添加到了环境变量“PATH”中，理论上上面的Shell脚本可以使用“bash genfiletags”执行，但是Windows偏偏东施效颦，也有“find”和“sort” 命令，所以我只好将Cygwin的“find.exe”和“sort.exe”各 复制一份，分别命名为“true_find.exe”和“true_sort.exe”， 并将上面的脚本改为：
-
#!/bin/sh
-
# generate tag file for lookupfile plugin
-
echo -e "!_TAG_FILE_SORTED\t2\t/2=foldcase/" > filenametags
-
true_find . -not -regex '.*\.\(png\|gif\)' ! -path "*svn*" -type f -printf "%f\t%p\t1\n" | true_sort -f >> filenametags
然后保存为“genfiletags.sh”。另外创建一个批处理文件“genfiletags.bat”， 内容如下：
@echo off
bash genfiletags.sh
最后，将这两个文件复制到环境变量“PATH”包含的一个目录中。
到这里，lookupfile已经可以正常工作了，只需在Vim中cd到项目的根目录，然后使用“:!genfiletags” 命令生成Tags文件，最后使用命令“:let g:LookupFile_TagExpr='"./filenametags"'” 告诉lookupfile使用这个文件作为查找源，就可以使用“:LookupFile”命令查找和打开文件了。
但我希望效率更高一些，因此在Vim的配置文件中加入以下代码：
-
" 指定英文逗号作为<leader>键
-
let mapleader= ","
-
-
" 在指定目录生成filenametags，并使lookupfile将这个文件作为查找源
-
function SetRootOfTheProject (path )
-
" 进入指定目录
-
exe 'cd '.a:path
-
" 生成文件标签
-
exe '!genfiletags'
-
" 获取标签文件的路径
-
let tagFilePath = genutils#CleanupFileName(a:path.'/filenametags')
-
" 设置LookupFile插件的全局变量，使之以上面生成的标签文件作为查找源
-
exe "let g:LookupFile_TagExpr='\"" .tagFilePath . "\"'"
-
endfunction
-
" 设置当前位置为工程的根目录
-
function SetHereTheRoot ( )
-
call SetRootOfTheProject ( '.' )
-
endfunction
-
nmap <leader >root : call SetHereTheRoot ( ) <CR >
-
" 从用户的输入获取指定路径，并设置为工程的根目录
-
function SetSpecifiedPathTheRoot ( )
-
call SetRootOfTheProject ( input ( '请输入工程根目录的路径：' ) )
-
endfunction
-
nmap <leader >xroot : call SetSpecifiedPathTheRoot ( ) <CR >
-
-
" 使用LookupFile打开文件
-
nmap <leader >o :LookupFile <CR >
以后只需要在Vim中cd到项目的根目录并在常规模式下输入“,root” 即可完成从生成Tags文件到指定该文件作为LookupFile查找源的工作，然后每次在常规模式下输入“,o”即 可打开LookupFile窗口输入查询条件了。
下面是一些LookupFile常用的技巧：
- 每次打开LookupFile窗口时，会默认显示上一次的查询条件或上一次打开的文件的完整路径，可以使用“Ctrl+U” 快捷键清空
- 对于查询出来的匹配项，在Windows下可以使用上下方向箭头选择，但在Linux下不能这样做，可使用“Ctrl+N” 进行选择
- 回车会直接在当前Buffer中打开选中的匹配项，可以使用“Ctrl+O”在Split窗口中打开
LookupFile使写程序变得更加妙趣横生，它使文件的查询和打开也可以变得非常地高效和优雅，唯独Windows下那极端邪恶的黑窗口，像个 无法摆脱的梦魇，龇牙咧嘴地嘲笑着WinSlave们。
2009-07-03 更新：
对于Windows用户，要特别注意的是，在将上面的genfiletags.sh脚本的内容复制到文本编辑器并保存时，一定要保存为Unix格式的文本 文件。
一种方法为，使用Vim打开genfiletags.sh，使用命令“:set fileformat=unix”并 保存。
下图是使用lookupfile插件查找文件的一个例子：
在屏幕最上方的窗口就是lookupfile窗口，在这个窗口中输入“gui.*x11”几个字符，查找到6个匹配文件，使用CTRL-N选中 gui_x11.c文件，然后按回车，就会在前一个窗口中打开src/gui_x11.c文件，lookupfile窗口也自动关闭了。是不是非常方便？
[缓冲区查找]
在开发过程中，我经常会同时打开数十甚至上百个文件。即使是使用BufExplorer插件，想在这么多buffer中切换到自己所要的文件，也不是件容易的事。
Lookupfile插件提供了一个按缓冲区名字查找缓冲区的方式，只要输入缓冲区的名字（可以是正则表达式），它就可以把匹配的缓冲区列在下拉列表中，同时还会列出该缓冲区内文件的路径，当你的buffer中有多个同名文件时，这可以帮你迅速找到你想要的文件。
使用“:LUBufs”命令开始在缓冲区中查找，输入缓冲区的名字，在你输入的过程中，符合条件的缓冲区就显示在下拉列表中了，选中所需缓冲区后，按回车，就会切换你所选的缓冲区。下图是一个示例：
[浏览目录]
Lookupfile插件还提供了目录浏览的功能，使用“:LUWalk”打开lookupfile窗口后，就可以输入目录，lookupfile 会在下拉列表中列出这个目录中的所有子目录及文件供选择，如果选择了目录，就会显示这个目录下的子目录和文件；如果选择了文件，就在VIM中打开这个文 件。
下图是使用LUWalk的一个抓图：
Lookupfile插件还提供了LUPath和LUArgs两个功能，这两个功能我用的不多，就不在这里介绍了。感兴趣的朋友读一下lookupfile的帮助页。
[Lookupfile配置]
Lookupfile插件提供了一些配置选项，通过调整这些配置选项，使它更符合你的工作习惯。下面是我的vimrc中关于lookupfile的设置，供参考：
""""""""""""""""""""""""""""""
" lookupfile setting
""""""""""""""""""""""""""""""
let g:LookupFile_MinPatLength = 2 "最少输入2个字符才开始查找
let g:LookupFile_PreserveLastPattern = 0 "不保存上次查找的字符串
let g:LookupFile_PreservePatternHistory = 1 "保存查找历史
let g:LookupFile_AlwaysAcceptFirst = 1 "回车打开第一个匹配项目
let g:LookupFile_AllowNewFiles = 0 "不允许创建不存在的文件
if filereadable("./filenametags") "设置tag文件的名字
let g:LookupFile_TagExpr = '"./filenametags"'
endif
nmap <silent> <leader>lk <Plug>LookupFile<cr> "映射LookupFile为,lk
nmap <silent> <leader>ll :LUBufs<cr> "映射LUBufs为,ll
nmap <silent> <leader>lw :LUWalk<cr> "映射LUWalk为,lw
有了上面的定义，当我输入”,lk”时，就会在tag文件中查找指定的文件名；当输入”,ll”时，就会在当前已打开的buffer中查找指定名字的buffer；当输入”,lw”时，就会在指定目录结构中查找。
另外，我还在项目相关的配置文件vim70sx.vim（参考本系列第4篇文章）中加入了lookupfile所使用的tag文件的信息：
let g:LookupFile_TagExpr = '"filenametags"'
这样，在恢复前次会话时就给lookupfile插件定义了tag文件。
在用lookupfile插件查找文件时，是区分文件名的大小写的，如果想进行忽略大小写的匹配，可以使用VIM忽略大小写的正则表达式，即在文件 名的前面加上“\c”字符。举个例子，当你输入“\cab.c”时，你可能会得到“ab.c”、“Ab.c”、“AB.c”……。
注：如果想加快lookupfile忽略大小写查找的速度，在生成文件名tag文件时，使用混合大小写排序。这在本系列的第5篇文章中有所提及。
通常情况下我都进行忽略大小写的查找，每次都输入“\c”很麻烦。没关系，lookupfile插件提供了扩展功能，把下面这段代码加入你的vimrc中，就可以每次在查找文件时都忽略大小写查找了：
" lookup file with ignore case
function! LookupFile_IgnoreCaseFunc(pattern)
let _tags = &tags
try
let &tags = eval(g:LookupFile_TagExpr)
let newpattern = '\c' . a:pattern
let tags = taglist(newpattern)
catch
echohl ErrorMsg | echo "Exception: " . v:exception | echohl NONE
return ""
finally
let &tags = _tags
endtry
" Show the matches for what is typed so far.
let files = map(tags, 'v:val["filename"]')
return files
endfunction
let g:LookupFile_LookupFunc = 'LookupFile_IgnoreCaseFunc'
有时在LUBufs时也需要忽略缓冲区名字的大小写，我是通过直接修改lookupfile插件的方法，在LUBufs查找的字符串前都加上“\c”，使之忽略大小写。如果你不想这样，可以每次在缓冲区名字前手动加上“\c”。