282 lines
14 KiB
Markdown
282 lines
14 KiB
Markdown
![][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
|
||
sudo ./install.sh
|
||
```
|
||
|
||
### Centos
|
||
|
||
- 版本要求
|
||
|
||
`centos7`及其以上`64`位系统。
|
||
|
||
- 安装vimplus
|
||
|
||
```bash
|
||
git clone https://github.com/chxuan/vimplus.git ~/.vimplus
|
||
cd ~/.vimplus
|
||
sudo ./install.sh
|
||
```
|
||
|
||
### ArchLinux
|
||
|
||
- 安装vimplus
|
||
|
||
```bash
|
||
git clone https://github.com/chxuan/vimplus.git ~/.vimplus
|
||
cd ~/.vimplus
|
||
sudo ./install.sh
|
||
```
|
||
|
||
个性化
|
||
------------
|
||
|
||
修改 `~/.vimrc.local` 文件内容，以启用个性化定制，可覆盖 `~/.vimrc` 中的设置。
|
||
|
||
|
||
插件列表
|
||
------------
|
||
|
||
| 插件 | 说明 |
|
||
| ------- | ----- |
|
||
| [vim-plug][4] | 比[Vundle][54]下载更快的插件管理软件 |
|
||
| [YouCompleteMe][5] | 史上最强大的基于语义的自动补全插件，支持C/C++、C#、Python、PHP等语言 |
|
||
| [cppfun][58] | 生成函数实现 |
|
||
| [change-colorscheme][27] | 随心所欲切换主题 |
|
||
| [NerdTree][6] | 代码资源管理器 |
|
||
| [Airline][8] | 可以取代[powerline][9]的状态栏美化插件 |
|
||
| [auto-pairs][10] | 自动补全引号、圆括号、花括号等 |
|
||
| [DoxygenToolkit][11] | Doxygen风格的注释插件 |
|
||
| [LeaderF][56] | 比[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实时预览 |
|
||
| [L9][28] | Vim-script库 |
|
||
| [indentLine][29] | 代码缩进对齐线 |
|
||
| [sparkup][31] | HTML标签补全 |
|
||
| [pydiction][32] | 基于字典的python语法补全 |
|
||
| [MatchTagAlways][33] | 高亮配对符 |
|
||
| [closetag][34] | HTML标签自动闭合 |
|
||
| [a.vim][35] | .h .cpp文件快速切换 |
|
||
| [vim-fugitive][36] | 集成Git |
|
||
| [vim-slash][50] | 优化搜索，移动光标后清除高亮 |
|
||
| [vim-nerdtree-syntax-highlight][52] | NerdTree文件类型高亮 |
|
||
| [nerdtree-git-plugin][53] | NerdTree显示git状态 |
|
||
| [echodoc][57] | 补全函数时在命令栏显示函数签名 |
|
||
|
||
|
||
快捷键
|
||
------------
|
||
|
||
以下是部分快捷键，更详细的快捷键请查阅[vimplus帮助文档][59]。
|
||
|
||
| 快捷键 | 说明 |
|
||
| ------- | ----- |
|
||
| `,` | Leader Key |
|
||
| `<leader>n` | 打开/关闭代码资源管理器 |
|
||
| `<leader>t` | 打开/关闭函数列表 |
|
||
| `<leader>a` | .h .cpp 文件切换 |
|
||
| `<leader>i` | 转到函数声明 |
|
||
| `<leader>u` | 转到函数实现 |
|
||
| `<leader>o` | 打开include文件 |
|
||
| `<leader>y` | 拷贝函数声明 |
|
||
| `<leader>p` | 生成函数定义 |
|
||
| `<leader>w` | 单词跳转 |
|
||
| `<leader>f` | 搜索~目录下的文件 |
|
||
| `<leader><leader>f` | 语法错误自动修复(FixIt) |
|
||
| `<F5>` | 显示语法错误提示窗口 |
|
||
| `<F7>` | 启用markdown实时预览 |
|
||
| `<F8>` | 关闭markdown实时预览 |
|
||
| `<F9>` | 显示上一主题 |
|
||
| `<F10>` | 显示下一主题 |
|
||
| `<leader>l` | 按竖线对齐 |
|
||
| `<leader>=` | 按等号对齐 |
|
||
| `gcc` | 注释代码 |
|
||
| `:DirDiff <dir1> <dir2>` | 目录比较 |
|
||
| `vif` | 选中函数内容 |
|
||
| `dif` | 删除函数内容 |
|
||
| `cif` | 改写函数内容 |
|
||
| `vaf` | 选中函数内容（包括函数名 花括号） |
|
||
| `daf` | 删除函数内容（包括函数名 花括号） |
|
||
| `caf` | 改写函数内容（包括函数名 花括号） |
|
||
|
||
Q & A
|
||
------------
|
||
|
||
- **`安装vimplus后Airline等插件有乱码，怎么解决？`**
|
||
|
||
linux和mac系统需设置终端字体为`Droid Sans Mono Nerd Font`。
|
||
|
||
- **`xshell连接远程主机使用vim-devicons。`**
|
||
|
||
windows系统安装[Nerd Font][51]字体后并更改xshell字体即可。
|
||
|
||
- **`安装vimplus会经常失败，安装了几次都不成功！！！`**
|
||
|
||
vimplus安装时需要访问外国网站，由于网络原因，可能会失败，安装成功也要1个多小时，ycm插件有200M左右，下载比较耗时，这里有下载好的[YouCompleteMe.tar.gz][37]文件，下载后解压到~/.vim/plugged/目录，并进入YouCompleteMe目录执行`./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)，安装后即可正常使用。
|
||
|
||
- **`以上没有我遇到的问题怎么办？`**
|
||
|
||
您可以通过上网找解决方法，或提[Issues][39]，也可以通过发邮件方式`787280310@qq.com`一起讨论解决方法。
|
||
|
||
- **`vimplus用起来真的太棒了，怎么办？`**
|
||
|
||
那就麻烦您打赏一颗:star::star:吧，给予我继续维护的动力。
|
||
|
||
|
||
特性展示
|
||
------------
|
||
|
||
- YouCompleteMe
|
||
|
||
![][40]
|
||
|
||
- LeaderF
|
||
|
||
![][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/junegunn/vim-plug
|
||
[5]: https://github.com/Valloric/YouCompleteMe
|
||
[6]: https://github.com/scrooloose/nerdtree
|
||
[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
|
||
[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://github.com/Yggdroot/Images/blob/master/leaderf/leaderf_1.gif
|
||
[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
|
||
[51]: https://github.com/ryanoasis/nerd-fonts
|
||
[52]: https://github.com/tiagofumo/vim-nerdtree-syntax-highlight
|
||
[53]: https://github.com/Xuyuanp/nerdtree-git-plugin
|
||
[54]: https://github.com/VundleVim/Vundle.vim
|
||
[56]: https://github.com/Yggdroot/LeaderF
|
||
[57]: https://github.com/Shougo/echodoc.vim
|
||
[58]: https://github.com/chxuan/cppfun
|
||
[59]: https://github.com/chxuan/vimplus/blob/master/help.md
|