摘要：比如下表是它可用的所有選項是一個函數(shù)，用來創(chuàng)建自己的自動補全功能。如果第一個參數(shù)是一個命令字符或一個那么它會被用作對于高級用戶，可以傳入一個字典選項。希望大家可以結(jié)合創(chuàng)造出更多的使用方法。

fzf本身并不是一個vim 插件，本來作者只提供了基本的wrapper函數(shù)(比如fzf#run). 但后來作者發(fā)現(xiàn)很多人并不熟悉VIMScript, 所以就創(chuàng)建一個默認的vim plugin.

fzf可以異步地運行，不影響vim操作，比同類的其他插件都快得多。

有兩種安裝方式vundle或vim-plug

set rtp+=/home/harriszh/.fzf/
...
Plugin "junegunn/fzf.vim"

Plug "/usr/local/opt/fzf"
Plug "junegunn/fzf.vim"

如果你希望通過vim-plug來安裝fzf, 那么使用下面設(shè)置

Plug "junegunn/fzf", { "dir": "~/.fzf", "do": "./install --all" }
Plug "junegunn/fzf.vim"

這些命令都是FZF調(diào)用某個工具產(chǎn)生文件，文件內(nèi)容， tag， comment， command，然后FZF用一個小窗口把它們顯示出來，用戶就可以用模糊搜索的方式來選擇一個或多個選項，按下enter鍵后就可以用VIM打開它們或跳轉(zhuǎn)到相應(yīng)的行。
如Files針對的就是文件， GFiles針對的就是git文件

Files與FZF一樣的作用，它會列出所有文件，選中后vim會打開選中的文件

Buffers用于在存在于buffer中的文件間切換

Lines 用于在存在于buffer里的文件中尋找含有某個關(guān)鍵詞的行

BLines 和Lines類似，只不過它只在當前buffer里查找

因為ripgrep是目前性能最好的文本內(nèi)容搜索工具，所以我們可以自己定義一個命令

command! -bang -nargs=* Rg
   call fzf#vim#grep(
     "rg --column --line-number --no-heading --color=always --smart-case ".shellescape(), 1,
     0 ? fzf#vim#with_preview("up:60%")
             : fzf#vim#with_preview("right:50%:hidden", "?"),
     0)

這樣輸入:Rg 會調(diào)用ripgrep來遞歸搜索當前目錄

上面的命令都可以通過ctrl-t, ctrl-x, ctrl-v來在new tab, new split, new vsplit窗口打開

" This is the default extra key bindings
let g:fzf_action = {
   "ctrl-t": "tab split",
   "ctrl-x": "split",
   "ctrl-v": "vsplit" }

" Default fzf layout
" - down / up / left / right
let g:fzf_layout = { "down": "~40%" }

" In Neovim, you can set up fzf window using a Vim command
let g:fzf_layout = { "window": "enew" }
let g:fzf_layout = { "window": "-tabnew" }
let g:fzf_layout = { "window": "10split enew" }

" Customize fzf colors to match your color scheme
let g:fzf_colors =
 { "fg":      ["fg", "Normal"],
   "bg":      ["bg", "Normal"],
   "hl":      ["fg", "Comment"],
   "fg+":     ["fg", "CursorLine", "CursorColumn", "Normal"],
   "bg+":     ["bg", "CursorLine", "CursorColumn"],
   "hl+":     ["fg", "Statement"],
   "info":    ["fg", "PreProc"],
   "border":  ["fg", "Ignore"],
   "prompt":  ["fg", "Conditional"],
   "pointer": ["fg", "Exception"],
   "marker":  ["fg", "Keyword"],
   "spinner": ["fg", "Label"],
   "header":  ["fg", "Comment"] }

" Enable per-command history.
" CTRL-N and CTRL-P will be automatically bound to next-history and
" previous-history instead of down and up. If you don"t like the change,
" explicitly bind the keys to down and up in your $FZF_DEFAULT_OPTS.

let g:fzf_history_dir = "~/.local/share/fzf-history"

" [Buffers] 如果可能跳到已存在窗口
let g:fzf_buffers_jump = 1

" [[B]Commits] 自定義被"git log"使用的選項
let g:fzf_commits_log_options = "--graph --color=always --format="%C(auto)%h%d %s %C(black)%C(bold)%cr""

" [Tags] 定義用來產(chǎn)生tag的命令
let g:fzf_tags_command = "ctags -R"

" [Commands] --expect expression for directly executing the command
let g:fzf_commands_expect = "alt-enter,ctrl-x"

也可以使用autoload函數(shù)來定義自己的命令

" Command for git grep
" - fzf#vim#grep(command, with_column, [options], [fullscreen])
command! -bang -nargs=* GGrep
   call fzf#vim#grep(
     "git grep --line-number ".shellescape(), 0,
     { "dir": systemlist("git rev-parse --show-toplevel")[0] }, 0)

" Override Colors command. You can safely do this in your .vimrc as fzf.vim
" will not override existing commands.
command! -bang Colors
   call fzf#vim#colors({"left": "15%", "options": "--reverse --margin 30%,0"}, 0)

" Augmenting Ag command using fzf#vim#with_preview function
"   * fzf#vim#with_preview([[options], preview window, [toggle keys...]])
"     * For syntax-highlighting, Ruby and any of the following tools are required:
"       - Highlight: http://www.andre-simon.de/doku/highlight/en/highlight.php
"       - CodeRay: http://coderay.rubychan.de/
"       - Rouge: https://github.com/jneen/rouge
"
"   :Ag  - Start fzf with hidden preview window that can be enabled with "?" key
"   :Ag! - Start fzf in fullscreen and display the preview window above
command! -bang -nargs=* Ag
   call fzf#vim#ag(,
                   0 ? fzf#vim#with_preview("up:60%")
                           : fzf#vim#with_preview("right:50%:hidden", "?"),
                   0)

" Similarly, we can apply it to fzf#vim#grep. To use ripgrep instead of ag:
command! -bang -nargs=* Rg
   call fzf#vim#grep(
     "rg --column --line-number --no-heading --color=always --smart-case ".shellescape(), 1,
     0 ? fzf#vim#with_preview("up:60%")
             : fzf#vim#with_preview("right:50%:hidden", "?"),
     0)

" Likewise, Files command with preview window
command! -bang -nargs=? -complete=dir Files
   call fzf#vim#files(, fzf#vim#with_preview(), 0)

" Mapping selecting mappings
nmap  (fzf-maps-n)
xmap  (fzf-maps-x)
omap  (fzf-maps-o)

" Insert mode completion
imap  (fzf-complete-word)
imap  (fzf-complete-path)
imap  (fzf-complete-file-ag)
imap  (fzf-complete-line)

" Advanced customization using autoload functions
inoremap   fzf#vim#complete#word({"left": "15%"})

fzf#run()是vim集成的核心函數(shù)，它接受一個字典變量作為輸入， 你至少要通過sink選項來告訴fzf如何處理選中的條目。
比如：

call fzf#run({"sink": "tabedit", "options": "--multi --reverse"})

call fzf#run({"source": "git ls-files", "sink": "e", "right": "40%"})

call fzf#run({"source": map(split(globpath(&rtp, "colors/*.vim")),
                           "fnamemodify(v:val, ":t:r")"),
             "sink": "colo", "left": "25%"})

下表是它可用的所有選項

fzf#vim#complete是一個helper函數(shù)，用來創(chuàng)建自己的自動補全功能。 如果第一個參數(shù)是一個命令字符或一個vim list, 那么它會被用作source.

" Replace the default dictionary completion with fzf-based fuzzy completion
inoremap   fzf#vim#complete("cat /usr/share/dict/words")

對于高級用戶，可以傳入一個字典選項。它的選項和fzf#run是一致的，除了下面幾個選項。

reducer (funcref)

把fzf的輸出轉(zhuǎn)成單一字符串

prefix (funcref or string; default: k*$)

用于匹配想自動補全字符串的正則表達式

或者是一個函數(shù)

source或options可以是一個函數(shù)引用， 它用prefix作為輸入?yún)?shù)，返回最終的值

sink或sink*被忽略

" 全局補全 (不僅僅是buffers. 需要安裝ripgrep)
inoremap   fzf#vim#complete(fzf#wrap({
   "prefix": "^.*$",
   "source": "rg -n ^ --color always",
   "options": "--ansi --delimiter : --nth 3..",
   "reducer": { lines -> join(split(lines[0], ":zs")[2:], "") }}))

Reducer例子：

function! s:make_sentence(lines)
return substitute(join(a:lines), "^.", "=toupper(submatch(0))", "")."."
endfunction

inoremap   fzf#vim#complete({
 "source":  "cat /usr/share/dict/words",
 "reducer": function("make_sentence"),
 "options": "--multi --reverse --margin 15%,0",
 "left":    20})

結(jié)合FZF，vim可實現(xiàn)快速文件跳轉(zhuǎn)，特別是在結(jié)合Rg或ctags或git以后，可以快速地跳轉(zhuǎn)到滿足某種條件的文件中。
希望大家可以結(jié)合FZF創(chuàng)造出更多的使用方法。有任何好點子，歡迎聯(lián)系本人