![][1]

An automatic configuration program for vim
===============================================

![][2]

安装
------------
### Mac OS X

- 安装[HomeBrew][3]
 
    ```bash
    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    ```

- 安装vimplus

    ```bash
    git clone https://github.com/chxuan/vimplus.git ~/.vimplus
    cd ~/.vimplus
    ./install.sh
    ```

### Ubuntu

- 版本要求

    `ubuntu14.04`及其以上`64`位系统。

- 安装vimplus

    ```bash
    git clone https://github.com/chxuan/vimplus.git ~/.vimplus
    cd ~/.vimplus
    ./install.sh
    ```

### Centos

- 版本要求

    `centos7`及其以上`64`位系统。

- 安装vimplus

    ```bash
    git clone https://github.com/chxuan/vimplus.git ~/.vimplus
    cd ~/.vimplus
    ./install.sh
    ```

### ArchLinux

- 安装vimplus

    ```bash
    git clone https://github.com/chxuan/vimplus.git ~/.vimplus
    cd ~/.vimplus
    ./install.sh
    ```

个性化
------------

修改 `~/.vimrc.local` 文件内容，以启用个性化定制，可覆盖 `~/.vimrc` 中的设置。

插件列表
------------
 - [Vundle][4] - 基于Git仓库的插件管理软件。
 - [YouCompleteMe][5] - 史上最强大的基于语义的自动补全插件，支持C/C++、C#、Python、PHP等语言。
 - [NerdTree][6] - 树型目录插件。
 - [nerdcommenter][7] - 快速注释代码插件。
 - [Airline][8] - 可以取代[powerline][9]的状态栏美化插件。
 - [auto-pairs][10] - 自动补全引号、圆括号、花括号等。
 - [DoxygenToolkit][11] - Doxygen风格的注释插件。
 - [ctrlp][12] - 支持文件的模糊搜索工具。
 - [tagbar][13] - [taglist][14]的替代品，对正在编辑的文件生成大纲, 包含类/方法/变量等。
 - [vim-devicons][15] - 显示文件类型图标。
 - [vim-surround][16] - 自动增加、替换配对符的插件。
 - [vim-commentary][17] - 快速注释代码插件。
 - [vim-repeat][18] - 重复上一次操作。
 - [vim-endwise][19] - if/end/endif/endfunction补全插件。
 - [tabular][20] - 代码、注释、表格对齐插件。
 - [vim-dirdiff][21] - 目录比较工具。
 - [vim-coloresque][22] - 根据文本颜色值显示对于的颜色。
 - [vim-easymotion][23] - 强大的光标快速移动工具，强大到颠覆你的插件观。
 - [incsearch.vim][24] - 模糊字符搜索插件。
 - [vim-startify][25] - 起始页插件，可以看你之前打开过的文档。
 - [markdown-preview][26] - markdown文件的编辑以及实时预览插件。
 - [change-colorscheme][27] - 随心所欲的切换主题。
 - [L9][28] - Vim-script库。
 - [indentLine][29] - 代码缩进对齐线。
 - [FlyGrep][30] - 基于文本的模糊搜索插件。
 - [sparkup][31] - HTML标签补全插件。
 - [pydiction][32] - 基于字典的python语法补全插件。
 - [MatchTagAlways][33] - 高亮配对符。
 - [closetag][34] - HTML标签自动闭合工具。
 - [a.vim][35] - .h .cpp文件快速切换。
 - [vim-fugitive][36] - 集成Git插件。
 - [vim-slash][50] - 优化搜索，移动光标后清除高亮。

快捷键
------------

 - Leader键为 `,`
 - 打开/关闭目录树 `<Leader>n`
 - 显示函数、变量、宏列表 `<Leader>t`
 - 分析语法错误 `<F5>`
 - .h .cpp 文件切换 `<Leader>a`
 - 转到函数实现 `<Leader>u`
 - 转到函数声明 `<Leader>i`
 - 打开include文件 `<Leader>o`
 - 窗口切换 `Ctrl + P/Ctrl + N`
 - 光标位置切换 `Ctrl + O/Ctrl + I`
 - 模糊搜索文件 `Ctrl + f`
 - Surround `ys{motion or text-object}{char}/cs{orig_char}{dest_char}/ds{char}`
 - 注释 `gcc/gcap/gc/,ca/,cA`
 - 目录比较 `:DirDiff <dir1> <dir2>`
 - 重复上次操作 `.`
 - 改变主题颜色 `F9/F10`
 - 单词跳转 `<Leader>w`
 - 启用/关闭markdown实时预览 `F7/F8`

Q & A
------------

- **`安装vimplus后Airline等插件有乱码，怎么解决？`**

    linux和mac系统需设置终端字体为DroidSansMonofor Powerline Nerd Font。

- **`xshell连接远程主机使用NerdTree出现错位！！！`**

    执行rm -rf ~/vim/bundle/vim-devicons命令，将vim-devicons删除即可，或移动到其他地方。

- **`安装vimplus会经常失败，安装了几次都不成功！！！`**

    vimplus安装时需要访问外国网站，由于网络原因，可能会失败，安装成功也要1个多小时，ycm插件有200M左右，下载比较耗时，这里有下载好的[YouCompleteMe.tar.gz][37]文件，下载后解压到~/.vim/bundle/目录，并进入YouCompleteMe目录执行sudo ./install.py --clang-completer即可安装。

- **`使用第三方库时怎么让ycm补全第三方库API？`**

    vimplus安装完毕之后，`~`目录下将会生成两个隐藏文件分别是.vimrc和.ycm_extra_conf.py，其中.vimrc是vim的配置文件，.ycm_extra_conf.py是ycm插件的配置文件，当你需要创建一个project时，需要将.ycm_extra_conf.py拷贝到project的顶层目录，通过修改该配置文件里面的`flags`变量来添加你的第三方库路径。

- **`安装vimplus完成后ycm不能够工作！！！`**

    这里的原因可能就有很多了，可能每个人遇到的问题不一样，但`vimplus`尽最大努力不让用户操心，需要注意的是ycm插件只支持`64`位的系统，更多信息请访问[ycm官网][38]。

- **`在Archlinux环境下不能使用ycm怎么办？(缺少libtinfo.so.5)`**

    在Archlinux下可以试着使用pkgfile命令搜索依赖的文件具体在什么包内，目前找到的包含libtinfo.so.5的包是ncurses5-compat-libs(AUR)或者32位的lib32-ncurses5-compat-libs(AUR)，安装后即可正常使用。

- **`使用vimplus为什么不能补全JS、Go、Java等语言？`**

    目前vimplus只支持C、C++、Shell、vimscript、Python等语言补全，后序会支持更多的语言，若您真的需要使用其他语言，您可以在vimplus基础上扩展。

- **`以上没有我遇到的问题怎么办？`**

    您可以通过上网找解决方法，或提[Issues][39]，也可以通过发邮件方式`787280310@qq.com`一起讨论解决方法。

- **`vimplus用起来真的太棒了，怎么办？`**

    那就麻烦您打赏一颗星星吧，给予我继续维护的动力。

特性展示
------------

- YouCompleteMe 

    ![][40]

- ctrlp 

    ![][41]

- vim-airline

    ![][42]

- vim-surround

    ![][43]

- vim-commentary

    ![][44]

- auto-pairs

    ![][45]

- vim-easymotion

    ![][46]

- vim-devicons

    ![][47]

- vim-startify

    ![][48]

- markdown-preview

    ![][49]


  [1]: https://raw.githubusercontent.com/chxuan/vimplus/master/screenshots/vimplus-logo.png
  [2]: https://raw.githubusercontent.com/chxuan/vimplus/master/screenshots/main.png
  [3]: https://brew.sh/
  [4]: https://github.com/VundleVim/Vundle.vim
  [5]: https://github.com/Valloric/YouCompleteMe
  [6]: https://github.com/scrooloose/nerdtree
  [7]: https://github.com/scrooloose/nerdcommenter
  [8]: https://github.com/vim-airline/vim-airline
  [9]: https://github.com/powerline/powerline
  [10]: https://github.com/jiangmiao/auto-pairs
  [11]: https://github.com/vim-scripts/DoxygenToolkit.vim
  [12]: https://github.com/ctrlpvim/ctrlp.vim
  [13]: https://github.com/majutsushi/tagbar
  [14]: https://github.com/vim-scripts/taglist.vim
  [15]: https://github.com/ryanoasis/vim-devicons
  [16]: https://github.com/tpope/vim-surround
  [17]: https://github.com/tpope/vim-commentary
  [18]: https://github.com/tpope/vim-repeat
  [19]: https://github.com/tpope/vim-endwise
  [20]: https://github.com/godlygeek/tabular
  [21]: https://github.com/will133/vim-dirdiff
  [22]: https://github.com/gko/vim-coloresque
  [23]: https://github.com/easymotion/vim-easymotion
  [24]: https://github.com/haya14busa/incsearch.vim
  [25]: https://github.com/mhinz/vim-startify
  [26]: https://github.com/iamcco/markdown-preview.vim
  [27]: https://github.com/chxuan/change-colorscheme
  [28]: https://github.com/vim-scripts/L9
  [29]: https://github.com/Yggdroot/indentLine
  [30]: https://github.com/wsdjeg/FlyGrep.vim
  [31]: https://github.com/rstacruz/sparkup
  [32]: https://github.com/rkulla/pydiction
  [33]: https://github.com/Valloric/MatchTagAlways
  [34]: https://github.com/docunext/closetag.vim
  [35]: https://github.com/vim-scripts/a.vim
  [36]: https://github.com/tpope/vim-fugitive
  [37]: https://pan.baidu.com/s/1i481Eeh
  [38]: https://github.com/Valloric/YouCompleteMe
  [39]: https://github.com/chxuan/vimplus/issues
  [40]: https://camo.githubusercontent.com/1f3f922431d5363224b20e99467ff28b04e810e2/687474703a2f2f692e696d6775722e636f6d2f304f50346f6f642e676966
  [41]: https://camo.githubusercontent.com/e15ac916ab9a14dd07135cb2d985cc7333200a38/687474703a2f2f692e696d6775722e636f6d2f614f63774877742e706e67
  [42]: https://camo.githubusercontent.com/ba79534309330accd776a8d2a0712f7c4037d7f9/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f3330363530322f313037323632332f34346332393261302d313439352d313165332d396365362d6463616461336631633533362e676966
  [43]: https://camo.githubusercontent.com/1f02cead8bdcf894f26b0006c44068a33a7dc8e5/687474703a2f2f6a6f65646963617374726f2e636f6d2f7374617469632f70696374757265732f737572726f756e645f656e2e676966
  [44]: https://camo.githubusercontent.com/2f5cb5bc9a964b0d9e623b5b3aff0314294ac841/687474703a2f2f6a6f65646963617374726f2e636f6d2f7374617469632f70696374757265732f636f6d6d656e746172795f656e2e676966
  [45]: https://camo.githubusercontent.com/372b34413e710cdbc95c5a5c1f901baf9e77791d/687474703a2f2f6a6f65646963617374726f2e636f6d2f7374617469632f70696374757265732f736d617274696e7075745f656e2e676966
  [46]: https://camo.githubusercontent.com/d5f800b9602faaeccc2738c302776a8a11797a0e/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f333739373036322f323033393335392f61386539333864362d383939662d313165332d383738392d3630303235656138333635362e676966
  [47]: https://raw.githubusercontent.com/wiki/ryanoasis/vim-devicons/screenshots/v0.9.x/overall-screenshot.png
  [48]: https://raw.githubusercontent.com/mhinz/vim-startify/master/images/startify-menu.png
  [49]: https://cloud.githubusercontent.com/assets/5492542/15363504/839753be-1d4b-11e6-9ac8-def4d7122e8d.gif
  [50]: https://github.com/junegunn/vim-slash