Skip to content
This repository
Fetching contributors…

Cannot retrieve contributors at this time

file 73 lines (54 sloc) 2.326 kb

ctrlp.vim

Full path fuzzy file, buffer and MRU file finder for Vim.

  • Written in pure Vimscript for MacVim and Vim 7.0+.
  • Has full support for Vim’s regexp as search pattern.
  • Can also find file in most recently used files.

ctrlp

Basic Usage

  • Press <c-p> or run :CtrlP to invoke CtrlP.

Once CtrlP is open:

  • Press <c-f> and <c-b> to switch between find file, buffer, and MRU file modes.
  • Press <c-d> to switch to filename only search instead of full path.
  • Use * or | in the prompt to submit the string as a Vim’s regexp pattern.
  • Or press <c-r> to switch to full regexp search mode.
  • End the input string with a colon : followed by a command to execute after opening the file.
    e.g. abc:45 will open the file matched the pattern and jump to line 45.
  • Submit two dots .. as the input string to go backward the directory tree by 1 level.
  • Use <c-y> to create a new file and its parent dirs.

Basic Options

  • Change the mapping to invoke CtrlP:

    let g:ctrlp_map = '<c-p>'
    
  • When CtrlP is invoked, it automatically sets the working directory according to this variable:

    let g:ctrlp_working_path_mode = 1
    

    0 - don’t manage working directory.
    1 - the parent directory of the current file.
    2 - the nearest ancestor that contains one of these directories or files:

    .git/
    .hg/
    .bzr/
    _darcs/
    root.dir
    .vimprojects
    
  • You can also use the set-working-directory functionality above outside of CtrlP by adding the following line to your vimrc.
    The parameter is the same (0, 1 or 2):

    au BufEnter * cal ctrlp#SetWorkingPath(2)
    
  • Enable/Disable Most Recently Used files monitoring and its functionalities:

    let g:ctrlp_mru_files = 1
    
  • If you want to exclude directories or files from the search, you can use the Vim’s option wildignore.
    e.g. Just have something like this in your vimrc:

    set wildignore+=*/.git/*,*/.hg/*,*/.svn/*   " for Linux/MacOSX
    set wildignore+=.git\*,.hg\*,.svn\*         " for Windows
    

Check the docs for more mappings, commands and options.

Something went wrong with that request. Please try again.