---

Ⅰ. 插件描述

Vim plugin for searching the local filesystem for files by name or content, using glob or regular expression patterns.

Ⅱ. 基本信息

创建日期：  2011-06-27 使用用户：  9 Github星：  14 插件作者：  Jeet Sukumaran

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'jeetsukumaran/filesearch'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'jeetsukumaran/filesearch'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'jeetsukumaran/filesearch'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/jeetsukumaran/vim-filesearch

Ⅳ. 文档说明

'Filesearch' is a plugin for searching the local filesystem for files by name
or content. The searches can be done using either glob patterns (searching for
filenames only) or regular expression patterns (searching for filenames or
file content).

Three commands are provided:

:Fsglob /{glob}/[filetype-options] [paths]

    Search filesystem for files with names matching the glob pattern
    given by {glob}, which can include wildcard characters.

:Fsfind /{pattern}/[filetype-options] [paths]

    Search filesystem for files with names matching the regular expression
    pattern given by {pattern}.

:Fsgrep /{pattern}/[filetype-options] [paths]

    Search filesystem for files with lines of content matching the regular
    expression pattern {pattern}.

By default searches are carried out recursively starting from the current
directory, but the search paths can be adjusted through the use of optional

1. Searches can also be restricted to specific filetypes through the
2. of filetype filter options (e.g., "py" for Python files, "cpp" for C++

source and header files).

Results will be shown in new buffer (the "catalog viewer"). They can be
browsed using all the normal Vim movement keys, and can be selected for
viewing the in main (previous) window, a new vertical or horizontal split
window, or new tab page.

Detailed usage description is given in the help file, which can be viewed
on-line here:

http://github.com/jeetsukumaran/vim-filesearch/blob/master/doc/filesearch.txt

The public source code repository can be found here:

http://github.com/jeetsukumaran/vim-filesearch

Vim has much of this functionality built-in (e.g. "vimgrep", "find"). But I
find that the browsing, navigation and management of the results from these
native Vim commands not the most convenient. For example, :find automatically
goes to the first match, and you have to type :2find to go to the second

1. I would prefer to view the results in single buffer, apply normal Vim
2. and movement commands to navigate to the results of my choice, and the

ability to easily open target files/lines in a new window or tab page. There
are also a number of plugins that do achieve something similar (e.g., the
excellent 'Ack' plugin). But I wanted to be able to use Vim-dialect regular
expressions when working inside Vim, and also wanted a little more control over
how the results are displayed and sorted. Thus, I wrote this plugin.