LeaderF – 超级好用的VIM全局搜索插件

This plugin is mainly used for locating files, buffers, mrus, tags in large project.

• Written in Python.
• Support fuzzy and regex searching.
• Manage buffers and mrus.
• Open multiple files at once.
• Extensible.

Screenshots

Requirements

• vim7.3 or higher. Only support vim7.4.330 or higher after v1.01.
• vim compiled with Python support, you can check by using echo has('python') or echo has('python3') to see if the result is 1; Make sure that your python2 version is Python 2.7 or higher and python3 version is Python 3.1 or higher.

Installation

To install this plugin just put the plugin files in your ~/.vim (Linux) or ~/vimfiles (Windows).
For Vundle user, just add Plugin 'Yggdroot/LeaderF' to your .vimrc.

Performance

LeaderF is already very fast. If you want better performance, install the C extension of the fuzzy matching algorithm, which is more than 10 times faster. To install the C extension, follow the below:

• On Linux/Unix/MacOS:

  First, make sure python and/or python3 commands are available.
  Then run the installation script:

  cd ~/.vim/bundle/LeaderF
  ./install.sh

  Uninstall the C extension:

   ./install.sh --reverse
  

  If you are using vim-plug:

   Plug 'Yggdroot/LeaderF', { 'do': './install.sh' }
  

• On Windows:

  First, make sure py and/or py -3 commands are available.
  Then run the installation script:

  cd ~\.vim\bundle\LeaderF
  .\install.bat

  There may be some error during the installation, please google the error messages to resolve it.

  Uninstall the C extension:

   .\install.bat --reverse
  

  If you are using vim-plug:

   Plug 'Yggdroot/LeaderF', { 'do': '.\install.bat' }
  

After running any command of LeaderF, check the value of echo g:Lf_fuzzyMatch_C, if the value is 1, it means the C extension is loaded sucessfully.

Usage

Once LeaderF is launched:

Input formats:

• In NameOnly mode (fuzzy)

  'abc' is interpreted as vim’s regexp 'a.\{-}b.\{-}c'.
  If the first character you input is ';', then the searching will be the same as in FullPath mode.
  If you input string as 'abc;def', then 'abc' will match the file name and 'def' will match the directory name.

• In FullPath mode (fuzzy)

  Same as in NameOnly mode except that the pattern will match the full path but not the file name only.

• In Regexp mode

  The input string is the same as the Vim’s regexp.

Customization

• Change key bindings

  By default, <ESC> is the shortcut key to switch to normal mode, if you want to change it to be ‘Quit from LeaderF’:

  let g:Lf_CommandMap = {'<C-C>': ['<Esc>', '<C-C>']}

• Customize the statusline

  Please refer to here.

• Change the highlight of matched string

  highlight Lf_hl_match gui=bold guifg=Blue cterm=bold ctermfg=21
  highlight Lf_hl_matchRefine  gui=bold guifg=Magenta cterm=bold ctermfg=201

• Change the default mapping of searching files command

  e.g. let g:Lf_ShortcutF = '<C-P>'

License

This plugin is released under the Apache License, Version 2.0 (the “License”).