vim安装YouCompleteMe插件

> 参考 [一步一步带你安装史上最难安装的 vim 插件 —— YouCompleteMe](http://www.jianshu.com/p/d908ce81017a)以及[VIM、YouCompleteMe折腾配置以及clang+llvm编译安装](http://www.jianshu.com/p/c24f919097b3)

# 0x00 环境

* 系统：ubuntu14.04或者ubuntu16.04
* vim --version查看是否支持python2或者3，并且vim版本大于等于7.4.143

# 0x01 安装YCM

一般有两种安装方式，推荐使用第一种

## 通过Vundle安装YCM

### 安装 Vundle插件

```
git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim
```

### 在vim的配置文件 ~/.vimrc添加插件

```
call vundle#begin()
" 其他插件
Plugin 'Valloric/YouCompleteMe’
" 其他插件
call vundle#end()
```

配置完.vimrc保存，并运行:PluginInstall安装插件，该插件安装时间较长，须耐心等待

## 通过git安装YCM

### 下载 （在 `~/.vim/bundle` 目录下）
$ git clone --recursive [https://github.com/Valloric/YouCompleteMe.git](https://github.com/Valloric/YouCompleteMe.git)
### 检查完整性（在 `~/.vim/bundle/YouCompleteMe` 目录下）
$ git submodule update --init --recursive

# 0x02 下载最新版的libclang的预编译二进制文件

如果不需要C系语言的语义补全，则跳过0x02，否则继续

## 下载libclang的预编译二进制文件（version >= 3.9）

* 下载地址：http://llvm.org/releases/download.html

找个地方存放，比如我将解压之后的文件存放在`~/download/ycm_tmp_clang_llvm/`目录下，其下有bin,include,lib,libexec,share文件夹。

# 0x03 编译安装ycm_core库

## 安装编译YCM core库所需要的依赖

```
# python的开发包
sudo apt-get install python-dev python3-dev 
# boost的开发包 
sudo apt-get install libboost-dev libboost-all-dev 
```
ycm_core库是是YCM用来快速补全的C++引擎

## 创建一个新的文件夹

我创建了一个`~/download/ycm_build`文件夹用来存放构建文件。
```
mkdir ~/download/ycm_build
cd ~/download/ycm_build
```

## 生成`makefile`

### 如果不需要C系语言的语义支持

```
# 在`ycm_build`目录下执行：
cmake -G "Unix Makefiles" . ~/.vim/bundle/YouCompleteMe/third_party/ycmd/cpp
```

### 如果需要C系语言的语言支持

有三种情形：

1. 情况一：libclang手动下载（即本文采取的方式）
```
cmake -G "Unix Makefiles" -DPATH_TO_LLVM_ROOT=~/download/ycm_tmp_clang_llvm . ~/.vim/bundle/YouCompleteMe/third_party/ycmd/cpp
```
2. 情况二：采用系统自带的libclang
```
cmake -G "Unix Makefiles" -DUSE_SYSTEM_LIBCLANG=ON . ~/.vim/bundle/YouCompleteMe/third_party/ycmd/cpp
```
3. 情况三：采用自定义的libclang
```
# /path/to/libclang.so这部分填入你自己编译libclang的路径
cmake -G "Unix Makefiles" -DEXTERNAL_LIBCLANG_PATH=/path/to/libclang.so . ~/.vim/bundle/YouCompleteMe/third_party/ycmd/cpp
```

## 生成`ycm_core`
```
cmake --build . --target ycm_core --config Release
```

此时，YCM已经安装完成。上面提到的`ycm_build`以及`ycm_tmp_clang_llvm`目录均可以删除了。

# 0x04 配置、测试与其他

## 配置

ycm的编译配置，可以全局配置，也可以在项目文件下添加.ycm_extra_conf.py进行配置

* 比如指定全局的ycm编译的flag
```
# 复制 .ycm_extra_conf.py 文件
cp ~/.vim/bundle/YouCompleteMe/third_party/ycmd/examples/.ycm_extra_conf.py ~/.vim/
```
* 再添加vim配置
注意下面的 python 解释器的路径要和编译 ycm_core 的时候使用的 python 解释器是相同的版本（2 或 3）
```
" ~/.vimrc
let g:ycm_server_python_interpreter='/usr/bin/python'
let g:ycm_global_ycm_extra_conf='~/.vim/.ycm_extra_conf.py'
```

## 测试

新建hello.cpp文件，可看到如图下的自动补全

## 查看错误日志

运行`:YcmToggleLogs stderr`查看错误日志

逆风起笔