序言
使用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/