安装Vim插件 YouCompleteMe

Linux系统：Ubuntu 15.04，为Vim安装YouCompleteMe插件，有需要的朋友可以参考下。

0x00. 简介

YouCompleteMe号称Vim的自动补全神器，YouCompleteMe: a code-completion engine for Vim，该项目在github的地址：YouCompleteMe。

点击链接进去是下载界面：
https://github.com/Valloric/YouCompleteMe#ubuntu-linux-x64
下面是安装界面：

Ubuntu Linux x64

Please refer to the full Installation Guide below; the following commands are provided on a best-effort basis and may not work for you.

Make sure you have Vim 7.3.598 with python2 or python3 support. Ubuntu 14.04 and later have a Vim that's recent enough. You can see the version of Vim installed by running

vim
--version

. If the version is too old, you may need to compile Vim from source (don't worry,
it's easy).

Install YouCompleteMe with Vundle.

下面是安装Vundle 网页：https://github.com/VundleVim/Vundle.vim#about

Introduction:
Installation requires Git and triggers

git
clone

for each configured repository to

~/.vim/bundle/

by default. Curl is required for search.
If you are using Windows, go directly to Windows
setup. If you run into any issues, please consult the FAQ. See Tips for
some advanced configurations.
Using non-POSIX shells, such as the popular Fish shell, requires additional setup. Please check the FAQ.

Set up Vundle:

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

Configure Plugins:
Put this at the top of your

.vimrc

to
use Vundle. Remove plugins you don't need, they are for illustration purposes.

set nocompatible              " be iMproved, required
filetype off                  " required

" set the runtime path to include Vundle and initialize
set rtp+=~/.vim/bundle/Vundle.vim
call vundle#begin()
" alternatively, pass a path where Vundle should install plugins
"call vundle#begin('~/some/path/here')

" let Vundle manage Vundle, required
Plugin 'VundleVim/Vundle.vim'

" The following are examples of different formats supported.
" Keep Plugin commands between vundle#begin/end.
" plugin on GitHub repo
Plugin 'tpope/vim-fugitive'
" plugin from http://vim-scripts.org/vim/scripts.html Plugin 'L9'
" Git plugin not hosted on GitHub
Plugin 'git://git.wincent.com/command-t.git'
" git repos on your local machine (i.e. when working on your own plugin)
Plugin 'file:///home/gmarik/path/to/plugin'
" The sparkup vim script is in a subdirectory of this repo called vim.
" Pass the path to set the runtimepath properly.
Plugin 'rstacruz/sparkup', {'rtp': 'vim/'}
" Install L9 and avoid a Naming conflict if you've already installed a
" different version somewhere else.
Plugin 'ascenator/L9', {'name': 'newL9'}

" All of your Plugins must be added before the following line
call vundle#end()            " required
filetype plugin indent on    " required
" To ignore plugin indent changes, instead use:
"filetype plugin on
"
" Brief help
" :PluginList       - lists configured plugins
" :PluginInstall    - installs plugins; append `!` to update or just :PluginUpdate
" :PluginSearch foo - searches for foo; append `!` to refresh local cache
" :PluginClean      - confirms removal of unused plugins; append `!` to auto-approve removal
"
" see :h vundle for more details or wiki for FAQ
" Put your non-Plugin stuff after this line

Install Plugins:
Launch

vim

and
run

:PluginInstall

To install from command line:

vim
+PluginInstall +qall

Remember: YCM is a plugin with a compiled component. If you update YCM using Vundle and the ycm_core library APIs have changed (happens rarely), YCM will notify you to recompile it. You
should then rerun the install process.

Install development tools and CMake:

sudo apt-get install build-essential cmake

Make sure you have Python headers installed:

sudo apt-get install python-dev python3-dev

.

Compiling YCM with semantic support for C-family languages:

cd ~/.vim/bundle/YouCompleteMe
./install.py --clang-completer

Compiling YCM without semantic support for C-family languages:

cd ~/.vim/bundle/YouCompleteMe
./install.py

The following additional language support options are available:

C# support: add

--omnisharp-completer

when calling

./install.py

.
Go support: ensure go is installed and add

--gocode-completer

when calling

./install.py

.
TypeScript support: install nodejs and npm then install the TypeScript SDK
with

npm install -g typescript

.
JavaScript support: install nodejs and npm and add

--tern-completer

when
calling

./install.py

.
Rust support: install rustc and cargo and add

--racer-completer

when
calling

./install.py

.

To simply compile with everything enabled, there's a

--all

flag. So, to install with all language
features, ensure

npm

,

go

,

mono

,

rust

,
and

typescript

API are installed and in your

PATH

,
then simply run:

cd ~/.vim/bundle/YouCompleteMe
./install.py --all

That's it. You're done. Refer to the User Guide section on how to use YCM. Don't forget that if you want the C-family semantic completion engine to work, you will need to provide the compilation flags for your
project to YCM. It's all in the User Guide.

YCM comes with sane defaults for its options, but you still may want to take a look at what's available for configuration. There are a few interesting options that are conservatively turned off by default that you may want to turn
on.

0x01. Requirements

Vim is at least 7.3.584 and it has support for python2 scripting.

0x02. 用Vundle来安装YCM(YouCompleteMe)

安装其实非常简单，在.vimrc文件中加入语句 Bundle 'Valloric/YouCompleteMe' 即可，保存，退出，然后再次打开Vim，normal模式下输入 :BundleInstall 即开始下载。如下图：



也可以切换至 .vim/bundle 下手动下载，输入如下命令：

git clone https://github.com/Valloric/YouCompleteMe.git[/code] 
手动下载完后检查仓库的完整性，切换到 YouCompleteMe 目录下，输入如下命令：

git submodule update --init --recursive


0x03.  下载最新的libclang

Clang是一个开源的编译器，它可以编译C/C++/Objective-C/Objective-C++. Clang提供的libclang库是用来给YCM为这些语言提供语义补全的引擎。和YCM配合的libclang版本必须 >=3.6 ，但理论上也是可以和 3.2+ 版本的libclang配合使用的。下载最新的libclang如下：

sudo apt-get install libclang-dev


0x04. 编译YCM需要的ycm_support_libs库

首先要确保你已经安装类cmake。如果没有，请按如下安装：

sudo apt-get install cmake


其次需要确保你有一些 Python 头文件。如果没有，请按如下安装：

sudo apt-get install python-dev


接下来，创建新的文件夹 ycm_build 进行编译，如下：

1 cd ~
2 mkdir ycm_build
3 cd ycm_build


不需要语义补全的童鞋们，直接执行下面的语句：

cmake -G "Unix Makefiles" . ~/.vim/bundle/YouCompleteMe/third_party/ycmd/cpp


然并卵啊，俺们是需要语义补全的呀～，那么请先去 llvm.org 下载最新的 clang+llvm 包，然后把它们解压到 ~/ycm_temp/llvm_root_dir 文件夹下。接着，执行如下语句：

cmake -G "Unix Makefiles" -DPATH_TO_LLVM_ROOT=~/ycm_temp/llvm_root_dir . ~/.vim/bundle/YouCompleteMe/third_party/ycmd/cpp


再接着要开始编译 ycm_support_libs 库，执行如下语句：

make ycm_support_libs




这样就编译完了。

0x05. 配置YCM

本渣开始以为编译完了就完事了，谁知道再次打开Vim，它来了这么一句：No .ycm_extra_conf.py file detected, so no compile flags are available. Thus no semantic support for C/C++/ObjC/ObjC++. 哦呵呵呵～

进 ~/.vim/bundle/YouCompleteMe 文件夹下一看。。。没有 cpp ！没有 cpp ！没有 cpp ！

咋办？新建呗。。。然后把 YCM‘S own .ycm_extra_conf.py 文件拷贝到相应的文件夹下。

接着再次打开 .vimrc 配置YCM，如下：

"YouCompleteMe
let g:ycm_global_ycm_extra_conf='~/.vim/bundle/YouCompleteMe/cpp/ycm/.ycm_extra_conf.py'




之后再次打开Vim即可。

为了补全，我们还需要在 .ycm_extra_conf.py 文件中进行配置，如下：

1 '-isystem',
2 '/usr/include',
3 '-isystem',
4 '/usr/include/c++/4.9.2',
5 '-isystem',
6 '/usr/include',
7 '/usr/include/x86_64-linux-gnu/c++',




0x06. Summary

城里人真会玩:)



自己再配置配置可以起飞了～