序言
使用Ubuntu和vim已經有一段時間了,對於Vim下的插件應用,我總是抱着一股狂熱的態度。這次,又在網上閑逛着,發現了一個個人博客提到了Vim代碼補全這回事,並提到了YouCompleteMe這個插件。頓時激起了我折騰的欲望。以前我都是使用Ctags+<C-n>或<C-p>來進行補全,然而其命中率卻比較低,有時候根本就亂匹配。於是決定將YouCompleteMe這個插件安裝好適用一下,同時,用Vundle也好讓我將.vim文件夾下的文件清理一下.
一、准備
(1)相關鏈接
- PPA for vim 7.4. YouCompleteMe插件要求Vim 版本在7.3.584及以上,而Ubuntu13.04源中的Vim已經比較老了。所以,我們可以在源中添加PPA,或者編譯源碼手動更新VIM的版本。
- Vundle. 這是一個新生代vim插件管理器,使用git進行插件安裝和更新。以前有一個pathogen。插件管理器的好處是:使用簡單,自動化管理vim的插件。讓你的.vim文件夾遠離混亂不堪的窘境,從此一手.vimrc走天下。
- Clang+LLVM. LLVM+Clang是Apple公司資助的一個項目,YouCompleteMe精確的補全功能完全依賴於Clang的代碼解析。我們需要安裝好Clang 3.2+以便為YCM提供支持。
- SVN和Git。用於從代碼庫中檢出源代碼。在Ubuntu下這兩個軟件的安裝都非常簡單,使用apt-get命令即可安裝完成。
- YouCompleteMe和Syntastic.這兩個插件都是配合使用的。YCM不用再說,Syntastic用於源碼的實時檢查。具體效果如同Eclipse一樣,在代碼編寫的過程中即可實時報告語法錯誤。
- Cmake.后面在編譯過程中會使用到,安裝命令:sudo apt-get install cmake.
(2)配置VIM
- 升級到7.3.584+。Ubuntu下需要手動添加PPA(Personal Package Archives),可以使用命令行add-apt-repository來進行添加,如:
$ sudo add-apt-repository ppa:nmi/vim-snapshots $ sudo apt-get update $ sudo apt-get install vim
某些PPA也提供了源地址,那么就可以直接打開/etc/apt/source.list進行添加。二者的本質是一樣的。如從源碼編譯vim,可參考這里。
- 下載Vundle。Vundle托管在Github上,需要使用到git來檢出源代碼。
$ git clone https://github.com/gmarik/vundle.git ~/.vim/bundle/vundle
以上命令直接將源代碼檢出到了~/.vim/bundle/vundle這個目錄下。
- 下載完了vundle后,需要配置好.vimrc文件。需要配置的模板如下(摘在github):
set nocompatible " be iMproved filetype off " required! set rtp+=~/.vim/bundle/vundle/ call vundle#rc() " let Vundle manage Vundle " required! Bundle 'gmarik/vundle' " My bundles here: " " original repos on GitHub Bundle 'tpope/vim-fugitive' Bundle 'Lokaltog/vim-easymotion' Bundle 'rstacruz/sparkup', {'rtp': 'vim/'} Bundle 'tpope/vim-rails.git' " vim-scripts repos Bundle 'L9' Bundle 'FuzzyFinder' " non-GitHub repos Bundle 'git://git.wincent.com/command-t.git' " Git repos on your local machine (i.e. when working on your own plugin) Bundle 'file:///Users/gmarik/path/to/plugin' " ... filetype plugin indent on " required!
其中需要說明的是:filetype off這一條實際上並不需要。因為這條命令將導致語法着色失敗。我的.vimrc里面並沒配置這一條。當所需要的vim插件托管在Github上時,該插件的可寫成“Bundle 'scrooloose/syntastic'”;當插件在www.vim.org上面時,我們只需要寫明該插件的名稱,還要加上.vim擴展名。否則vundle無法更新該插件。基本上這兩種情況可以滿足我們大部分人的需要了。
-
vundle的使用。先將~/.vim/下面原先安裝的插件都"rm -rf"掉吧,由vundle來接手管理工作。打開一個vim窗口,執行命令:BundleInstall。接下來vundle會自動去網上將相關插件下載下來並安裝好。在此過程中,vundle還會:helptags命令。因此,我們可以直接在vim中查看插件的幫助文檔。要刪除一個插件也很簡單,先在~/.vimrc中移除該插件條目,然后進入vim執行命令:BundleClean。嘿嘿,vundle將自動清除掉插件的文件夾!狂拽炫酷吊炸天!
- 編譯LLVM+Clang的源代碼。在http://clang.llvm.org上面Clang 3.3並沒有Ubuntu13.04 32bit的預編譯的二進制程序,所以只好下載源碼進行手工編譯。命令如下:
//Checkout LLVM: cd llvmsrc svn co http://llvm.org/svn/llvm-project/llvm/trunk llvm //Checkout Clang: cd llvmsrc cd llvm/tools svn co http://llvm.org/svn/llvm-project/cfe/trunk clang //Checkout Compiler-RT: cd llvmsrc cd llvm/projects svn co http://llvm.org/svn/llvm-project/compiler-rt/trunk compiler-rt //Get the Test Suite Source Code [Optional] cd llvmsrc cd llvm/projects svn co http://llvm.org/svn/llvm-project/test-suite/trunk test-suite //Configure and build LLVM and Clang: cd llvmsrc mkdir build (for building without polluting the source dir) cd build ../llvm/configure --enable-optimized
以上步驟中唯一需要注意的是configure的時候,需要指定--enable-optimized參數。否則默認configure的將是Debug版本,問題多多。最后,我們使用make命令進行編譯。編譯過程比較長,耗時半個小時左右。這一步主要是為了下面編譯YouCompleteMe插件做准備。
二、配置
(1)編譯YouCompleteMe。沒錯,這個插件需要編譯!在Github項目說明中有詳細的安裝和使用方法,不過呢,官方說明中的Full Installation並沒有針對Ubuntu13.04 32bit的編譯說明,而且,該說明中使用的是預編譯Clang包。原先按照這個說明執行了一次,但是總是在libclang.so上面出錯,要不就是版本不對,要不就是根本不生成libclang.so。最后在網上找到了一個帖子,再結合官方說明編譯成功的。編譯步驟如下:
- 下載源碼。我們在前面使用vundle已經下載好了,因此這一步跳過。
- 執行命令:
$ cd ~ $ mkdir ~/ycm_build $ cd ~/ycm_build $ cmake -G "Unix Makefiles" ~/.vim/bundle/YouCompleteMe/cpp -DEXTERNAL_LIBCLANG_PATH=~/ycm_temp/llvmsrc/lib/libclang.so $ make ycm_core
這里要注意的是-DEXTERNAL_LIBCLANG_PATH這個參數,用於指定libclang.so的位置。如果不指定的話,YCM將無法正常工作,總是報:The YCM shut down, crash report...之類的錯誤。而這個libclang.so就是我們在編譯Clang的時候生成的。因此,相關路徑(也即~/ycm_temp/llvmsrc/lib/libclang.so)需要替換成自己對應的路徑。
-
關於make。在官方文檔中只使用了:make ycm_support_libs.而我在實際操作中卻屢屢失敗。實際上,首先要執行:make ycm_core。這樣將在~/.vim/bundle/YouCompleteMe/python/目錄下自動生成兩個文件(libclang.so和ycm_core.so),如下圖:
- 這還是不夠的,還必須執行命令:make ycm_support_libs。 這條命令才會生成第三個文件ycm_client_support.so。因為,YouCompleteMe是C/S架構的,所以存在服務器和服務端的說 法。另外,在/tmp/ycm_temp/目錄下還可以看到服務和請求日志,更加可以驗證這一點。
- 最后,為了能順利的完成配置工作,我們還需要配置一下.ycm_extra_conf.py這個文件。項目說明中有個配置模板,我們需要做改動的就是flags部分。使用-isystem標志添加系統的頭文件進行解析,而-I標志用於添加第三分的頭文件進行解析。我的flags在最后增加如下:
'-isystem', '/usr/include', '-isystem', '/usr/include/c++/', '-isystem', '/usr/include/i386-linux-gnu/c++'
此外,為了更好的提高補全效率,我們可以保留原先使用的用Ctags生成的tags文件,並在~/.vimrc中添加:let g:ycm_collect_identifiers_from_tag_files = 1.其中,在vim中使用 :echo tagfiles()可以查看當前使用的tags文件。至於生成tags文件的方法,可以看Ctags的幫助文件或者上網搜索。
- 至此,配置尚未結束。.ycm_extra_conf.py文件可以是針對工程而言,也可以設置全局的。對工程而言,放在工程的根目錄即可。不過每次打開文件都會詢問是否加載,這時可以在~/.vimrc中設置:let g:ycm_confirm_extra_conf=0來關閉提示。如果是針對全局的,那么可以在~/.vim/bundle/YouCompleteMe/cpp/ycm/.ycm_extra_conf.py中設置。如果沒有問題,應該可以看到YouCompleteMe強大的一面了,效果在下面。
(2)Syntastic和Vundle的安裝很簡單,主要在於配置,所以就不花時間講解安裝,看看配置就可以了。而重點和難點在於YouCompleteMe和Clang的編譯工作,這兩個編譯步驟都比較復雜,編譯耗時較長。所以花了很大篇幅講解。
三、附錄
(1)效果圖。這是補全C++的圖,圖中紅色的小叉是Syntastic的效果。如果需要補全C,還得去.ycm_extra_conf.py中修改一下。
沒有想到的是,YCM還能補全文件和目錄。。。
下面是Syntastic的效果圖,警告和錯誤標志可配置,光標在錯誤行時,vim的命令行會有相關錯誤信息:
(2)遇到的問題。
- libclang.so的版本一定要在3.2+,否則YCM無法正常工作。必須要通過上面的make ycm_core和make ycm_support_libs來生成上述的三個.so文件,不能手工拷貝。
- 如果出現bits/c++config.h文件無法找到的錯誤.那么可以考慮將系統中存在的c++config.h文件所在的文件夾中的所有文件,拷貝到/usr/include/c++/4.8/bits目錄下,參考鏈接!
(3)相關說明。
- 編譯vim源碼的時候,需要打開python選項。
- vundle中的插件條目,如果托管在www.vim.org上,需要加.vim擴展名。
- 一個較為完善的.vimrc模板。
- 我的部分插件配置:
""""""""" Settings of taglist"""""""""""""" " increase the width of the taglist window let Tlist_WinWidth=10 " automatically open the taglist window let Tlist_Auto_Open=0 " exit wim when only the taglist window exist let Tlist_Exit_OnlyWindow=1 " open tags with single click let Tlist_Use_SingleClick=1 " close tag folds for inactive buffers let Tlist_File_Fold_Auto_Close=1 " show the fold indicator column in the taglist window let Tlist_Enable_Fold_Column=1 " Automatically update the taglist to include newly edited files let Tlist_Auto_Update=1 """""""""" NERDtree settings""""""""""""""" let NERDTreeWinPos='right' """""""""" mini buffer navigator""""""""""" let g:miniBUfExplMapWindowNavVim=1 let g:miniBufExplMapWindowNavArrows=1 let g:miniBufExplMapCTabSwitchBufs=1 let g:miniBufExplModSelTarget=1 let g:miniBufExplUseSingleClick=1 """"""""""""ctags settings""""""""""""""""" set tags+=~/.vim/cpptags set tags+=~/.vim/systags """""""""""color scheme"""""""""""""""""""" let g:molokai_original=1 """"""""""""vundle""""""""""""""""""""""""" set nocompatible set rtp+=~/.vim/bundle/vundle/ call vundle#rc() " let Vundle manage Vundle " required! Bundle 'gmarik/vundle' """"""""vim scripts"""""""""""""""""" Bundle 'taglist.vim' Bundle 'c.vim' Bundle 'minibufexpl.vim' Bundle 'grep.vim' Bundle 'mru.vim' Bundle 'comments.vim' """"""""git repo""""""""""""""" Bundle 'scrooloose/nerdtree' Bundle 'Valloric/YouCompleteMe' Bundle 'vim-scripts/AutoClose' Bundle 'scrooloose/syntastic' Bundle 'Lokaltog/vim-powerline' """"""""""syntastic"""""""""""" let g:syntastic_check_on_open = 1 let g:syntastic_cpp_include_dirs = ['/usr/include/'] let g:syntastic_cpp_remove_include_errors = 1 let g:syntastic_cpp_check_header = 1 let g:syntastic_cpp_compiler = 'clang++' let g:syntastic_cpp_compiler_options = '-std=c++11 -stdlib=libstdc++' "set error or warning signs let g:syntastic_error_symbol = '✗' let g:syntastic_warning_symbol = '⚠' "whether to show balloons let g:syntastic_enable_balloons = 1 """"""""""""YCM"""""""""""""""""""" let g:ycm_global_ycm_extra_conf = '~/.vim/bundle/YouCompleteMe/cpp/ycm/.ycm_extra_conf.py' let g:ycm_collect_identifiers_from_tags_files = 1 let g:ycm_seed_identifiers_with_syntax = 1 let g:ycm_confirm_extra_conf = 0
- 推薦的較為好用的插件包括:
439 """"""""vim scripts"""""""""""""""""" 440 Bundle 'taglist.vim' 441 Bundle 'c.vim' 442 Bundle 'minibufexpl.vim' 443 Bundle 'grep.vim' 444 Bundle 'mru.vim' 445 Bundle 'comments.vim' 446 447 """"""""git repo""""""""""""""" 448 Bundle 'scrooloose/nerdtree' 449 Bundle 'Valloric/YouCompleteMe' 450 Bundle 'vim-scripts/AutoClose' 451 Bundle 'scrooloose/syntastic' 452 Bundle 'Lokaltog/vim-powerline'
Bundle 'kien/ctrlp.vim'
(4)參考鏈接:
- cold's world
- http://stackoverflow.com/questions/18028071/vim-c-ycm-and-syntastic-include-path-problems
- http://stackoverflow.com/questions/9201521/g-4-6-issue-no-bits-cconfig-h-file-as-required-by-the-header-cstring
- http://www.cplusplus.com/forum/unices/114261/
- http://blog.csdn.net/ywh147/article/details/13625905(價值較高)
- http://williamherry.com/blog/2012/08/25/master-vim-04-ctrlp/
- http://www.bestofvim.com/plugin/ctrl-p/