Vim自动补全神器–YouCompleteMe

YouCompleteMe的特别之处

基于语义补全

总所周知,Vim是一款文本编辑器.也就是说,其最基础的工做就是编辑文本,而无论该文本的内容是什么.在Vim被程序员所使用后,其慢慢的被肩负了与IDE同样的工做,文本自动补全(ie.acp,omnicppcompleter),代码检查(Syntastic)等等工做.javascript

针对文本自动补全这个功能来讲,主要有两种实现方式.php

  • 基于文本

咱们经常使用的omnicppcompleter,acp,vim自带的c-x, c-n的实现方式就是基于文本.更通俗的说法,其实就是一个字:html

其经过文本进行一些正则表达式的匹配,再根据生成的tags(利用ctags生成)来实现自动补全的效果.java

  • 基于语义

顾名思义,其是经过分析源文件,通过语法分析之后进行补全.因为对源文件进行分析,基于语义的补全能够作到很精确.可是这显然是vim所不可能支持的.并且通过这么多年发展,因为语法分析有很高的难度,也一直没有合适的工具出现.直到,由apple支持的clang/llvm横空出世.YouCompleteMe也正是在clang/llvm的基础上进行构建的.python

整合实现了多种插件

  • clang_complete
  • AutoComplPop
  • Supertab
  • neocomplcache
  • Syntastic(相似功能,仅仅针对c/c++/obj-c代码)

支持语言

  • c
  • c++
  • obj-c
  • c#
  • python

对于其余的语言,会调用vim设置的omnifunc来匹配,所以一样支持php,ruby等语言.c++

已知的有 * javascript —-tern_for_vim * ruby/java —-eclimgit

 

效果图:程序员

YouCompleteMe要求Vim版本7.3.584+,前面已经介绍了编译安装Vim7.4方法。 同时YouCompleteMe要求clang版本为3.3以上。若是想获取最新的clang可使用SVN,按照其官网上介绍的方法编译安装。咱们这里介绍源码编译安装clang3.3。github

 

编译安装llvm-clang3.3

先下载以下4个源码: llvm-3.3源码 clang-3.3源码 clang-tools-extra-3.3源码 compiler-rt-3.3源码 创建目录:正则表达式

mkdir ~/llvm-clang

分别解压上面下载的4个文件到上述目录

tar -xvzf llvm-3.3.src.tar.gz

tar -xvzf compiler-rt-3.3.src.tar.gz

tar -xvzf clang-tools-extra-3.3.src.tar.gz

tar -xvzf cfe-3.3.src.tar.gz

再将工具移动到llvm的相应目录下,使得clang,clang-tools-extra和compiler-rt就能够和llvm一块儿编译了:

mv cfe-3.3.src/ llvm-3.3.src/tools/clang/

mv clang-tools-extra-3.3.src/ llvm-3.3.src/tools/clang/extra/

mv compiler-rt-3.3.src/ llvm-3.3.src/projects/compiler-rt/

下载最新的LLVM、clang 及辅助库源码可用:

        cd ~/llvm-clang
        svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm
        cd llvm/tools
        svn co http://llvm.org/svn/llvm-project/cfe/trunk clang
        cd ../..
        cd llvm/tools/clang/tools
        svn co http://llvm.org/svn/llvm-project/clang-tools-extra/trunk extra
        cd ../../../..
        cd llvm/projects
        svn co http://llvm.org/svn/llvm-project/compiler-rt/trunk compiler-rt
        cd ..

返回~/llvm-clang目录,并新建一个目录llvm-build专门用于编译llvm-clang,使得不污染源码。

mkdir llvm-build

cd llvm-build/

../llvm-3.3.src/configure --enable-optimized

创建编译环境

此种配置后,llv-clang默认安装到目录 /usr/local/ 下, 若是想改变安装目录,则加上配置: --prefix=Path 来制定 输入 make -j4

(本人机器为双核)开始编译

sudo make install

进行安装

如要卸载则在该目录下输入

sudo make uninstall

安装好后,输入 clang -v查看版本信息:

安装clang标准库

clang 的标准库————libc++(接口层)和 libc++abi(实现层)须要安装头文件和动态连接库(*.so)。

  • 安装libc++
            cd ~/llvm-clang
            svn co http://llvm.org/svn/llvm-project/libcxx/trunk libcxx
            cd libcxx/lib
            ./buildit
    

头文件已经生成到 ~/llvm-clang/libcxx/include/,要让 clang 找到必须复制到 /usr/include/c++/v1/

cp -r ~/llvm-clang/libcxx/include/ /usr/include/c++/v1/

*.so 文件已生成 ~/llvm-clang/libcxx/lib/libc++.so.1.0,要让 clang 访问必须复 制到 /usr/lib/,并建立软连接

    ln -s ~/llvm-clang/libcxx/lib/libc++.so.1.0 ~/llvm-clang/libcxx/lib/libc++.so.1
    ln -s ~/llvm-clang/libcxx/lib/libc++.so.1.0 ~/llvm-clang/libcxx/lib/libc++.so
    cp ~/dllvm-clang/libcxx/lib/libc++.so* /usr/lib/
相似,源码安装 libc++abi 的头文件和动态连接库:
    cd  ~/llvm-clang/
    svn co http://llvm.org/svn/llvm-project/libcxxabi/trunk libcxxabi
    cd libcxxabi/lib
    ./buildit

头文件已经生成到 ~/llvm-clang/libcxxabi/include/,要让 clang 找到必须复制到 /usr/include/c++/v1/

cp -r ~/llvm-clang/libcxxabi/include/ /usr/include/c++/v1/

*.so 文件已生成 ~/llvm-clang/libcxx/lib/libc++abi.so.1.0,要让 clang 访问必 须复制到 /usr/lib/,并建立软连接

ln -s ~/llvm-clang/libcxxabi/lib/libc++abi.so.1.0 ~/llvm-clang/libcxxabi/lib/libc++abi.so.1

ln -s ~/llvm-clang/libcxxabi/lib/libc++abi.so.1.0 ~/llvm-clang/libcxxabi/lib/libc++abi.so

cp ~/llvm-clang/libcxxabi/lib/libc++abi.so* /usr/lib/

后续能够经过以下选项进行代码编译:

clang++ -std=c++11 -stdlib=libc++ -Werror -Weverything -Wno-disabled-macro- expansion -Wno-float-equal -Wno-c++98-compat -Wno-c++98-compat-pedantic -Wno- global-constructors -Wno-exit-time-destructors -Wno-missing-prototypes -Wno-padded -lc++ -lc++abi main.cpp

参数说明:

  • -std=c++11: 使用 C++11 新特性;
  • -stdlib=libc++: 指定使用 clang 的标准库头文件 /usr/include/c++/v1/;
  • -Werror: 将全部编译警告视为编译错误;
  • -Weverything: 打开全部编译警告选项。在 GCC 中,没法经过单个选项打开全部 编译警告,必须繁琐的同时指定 -Wall、-Wextra、以及大量分散的其余选项,为此clang 新增了 -Weverything。固然,有些警告意义不大,彻底可忽略,以下;
  • -Wno-disabled-macro-expansion:禁止使用宏表达式,忽略此警告;
  • -Wno-float-equal:浮点类型不该使用 != 和 == 运算符,忽略此警告;
  • -Wno-c++98-compat、-Wno-c++98-compat-pedantic:采用 C++11 新特性的代 码没法兼容 C++98,忽略此警告;
  • -Wno-global-constructors:在 main() 以前存在执行的代码,忽略此警告;
  • -Wno-exit-time-destructors:在 main() 以后存在执行的代码,忽略此警告;
  • -Wno-missing-prototypes:虽有函数定义但缺失函数原型,忽略此警告;
  • -Wno-padded:结构体大小应为 4 字节整数倍,忽略此警告(编译器自动调整对齐 边界);
  • -lc++:指定连接 /usr/lib/libc++.so 标准库;
  • -lc++abi:指定连接 /usr/lib/libc++abi.so 标准库。注意:这两个选项很是重 要,缺失将致使连接失败!

这些参数在YouCompleteMe的配置文件.ycm_extra_conf.py的flags中设置

安装配置YouCompleteMe

  1. 下载源码。使用vundle搞定,在vimrc文件中加入 
    Bundle 'Valloric/YouCompleteMe'
  2. 执行命令:
        $ cd ~
        $ mkdir ~/ycm_build
        $ cd ~/ycm_build
        $ cmake -G "Unix Makefiles" -DUSE_SYSTEM_LIBclang=ON -DEXTERNAL_LIBCLANG_PATH=CLANG_INSTALL_PATH/libclang.so . ~/.vim/bundle/YouCompleteMe/cpp  
    注意:这里的CLANG_INSTALL_PATH要替换成你本身libclang.so所在的目录,例如个人是/ycm_temp/llvmsrc/build/Release+Asserts/lib(即:上面步骤的编译llvm-clang所生成的),若是安装了的话在/usr/local/lib/下也有libclang.so,这个目录也能够。能够经过sudo find / -name "libclang.so" -print查看
  3. 在YouCompleteMe中生成libclang.so和ycm_core.so文件 
    执行 make ycm_core,这样将在~/.vim/bundle/YouCompleteMe/python/目录下自动生成两个文件(libclang.so和ycm_core.so)
  4. 这仍是不够的,还必须执行命令:make ycm_support_libs。 这条命令才会生成第三个文件ycm_client_support.so。由于,YouCompleteMe是C/S架构的,因此存在服务器和服务端的说法。
  5. 最后设置.ycm_extra_conf.py文件。
  6. 在.vimrc中添加配置:
    " 自动补全配置
    set completeopt=longest,menu	"让Vim的补全菜单行为与通常IDE一致(参考VimTip1228)
    autocmd InsertLeave * if pumvisible() == 0|pclose|endif	"离开插入模式后自动关闭预览窗口
    inoremap <expr> <CR>       pumvisible() ? "\<C-y>" : "\<CR>"	"回车即选中当前项
    "上下左右键的行为 会显示其余信息
    inoremap <expr> <Down>     pumvisible() ? "\<C-n>" : "\<Down>"
    inoremap <expr> <Up>       pumvisible() ? "\<C-p>" : "\<Up>"
    inoremap <expr> <PageDown> pumvisible() ? "\<PageDown>\<C-p>\<C-n>" : "\<PageDown>"
    inoremap <expr> <PageUp>   pumvisible() ? "\<PageUp>\<C-p>\<C-n>" : "\<PageUp>"
    
    "youcompleteme  默认tab  s-tab 和自动补全冲突
    "let g:ycm_key_list_select_completion=['<c-n>']
    let g:ycm_key_list_select_completion = ['<Down>']
    "let g:ycm_key_list_previous_completion=['<c-p>']
    let g:ycm_key_list_previous_completion = ['<Up>']
    let g:ycm_confirm_extra_conf=0 "关闭加载.ycm_extra_conf.py提示
    
    let g:ycm_collect_identifiers_from_tags_files=1	" 开启 YCM 基于标签引擎
    let g:ycm_min_num_of_chars_for_completion=2	" 从第2个键入字符就开始罗列匹配项
    let g:ycm_cache_omnifunc=0	" 禁止缓存匹配项,每次都从新生成匹配项
    let g:ycm_seed_identifiers_with_syntax=1	" 语法关键字补全
    nnoremap <F5> :YcmForceCompileAndDiagnostics<CR>	"force recomile with syntastic
    "nnoremap <leader>lo :lopen<CR>	"open locationlist
    "nnoremap <leader>lc :lclose<CR>	"close locationlist
    inoremap <leader><leader> <C-x><C-o>
    "在注释输入中也能补全
    let g:ycm_complete_in_comments = 1
    "在字符串输入中也能补全
    let g:ycm_complete_in_strings = 1
    "注释和字符串中的文字也会被收入补全
    let g:ycm_collect_identifiers_from_comments_and_strings = 0
    
    nnoremap <leader>jd :YcmCompleter GoToDefinitionElseDeclaration<CR> " 跳转到定义处
相关文章
相关标签/搜索