手把手教你配置linux下C++开发工具——vim+ycm(YouCompleteMe)，支持基于语义的自动补全和第三方库补全（史上最简单、史上最透彻、史上最全的终极解决方案）

本文链接：https://blog.csdn.net/lianshaohua/article/details/108225916

本文提供了一步到位的vim+ycm配置教程，适用于vim9.0和ycm最新版。详细讲解了从安装python、vim到配置ycm，支持语义补全和第三方库补全的全过程，包括解决可能出现的问题，确保最简单、最全面的解决方案。

摘要由CSDN通过智能技术生成

截止到目前，vim稳定版本已经到了9.1+，ycm（YouCompleteMe的简称）最新版本与几年前的安装配置截然不同了。之前网上很多教程也教不得法，生搬硬套，没有讲透彻。所以，才下定决心写一篇自认为史上最简单、史上最全的教程出来。

一、准备工作

1、安装python(ycm需要使用python3.6以上的版本，这里选择python3.8.5)：

1.1、进入download目录：cd download

1.2、下载python3.8.5：wget https://www.python.org/ftp/python/3.8.5/Python-3.8.5.tar.xz

1.3、解压： xz -d Python-3.8.5.tar.xz && tar -xvf Python-3.8.5.tar

1.4、进入Python-3.8.5目录：cd Python-3.8.5

1.5、配置：./configure --prefix=/usr --enable-shared --enable-optimizations --with-ssl

1.6、构建及安装：make -j 8 && sudo make install #构建完成后，会安装在/usr/bin目录

1.7、测试：在命令行输入python --version或python3 --version

如果遇到编译_ctypes的错误，建议先安装依赖包（sudo yum install libffi-devel或sudo apt install libffi-dev)

2、安装python3（python3.8)方法二：

sudo apt install python3-dev -y

即可完成安装，同时检查一下配置文件的目录是否存在：

二、安装vim8.2+ (v9.1)

1、下载vim 9.1.0701：git clone https://github.com/vim/vim.git

2、进入目录：cd vim

3、切换到最新的tag：git checkout v9.1.0701 #可使用git tag查看所有的tag

4、配置：./configure --prefix=/usr --enable-luainterp=yes --enable-mzschemeinterp --enable-perlinterp=yes --enable-python3interp=yes --enable-tclinterp=yes --enable-rubyinterp=yes --enable-cscope --enable-terminal --enable-autoservername --enable-multibyte --enable-xim --enable-fontset --with-modified-by=shlian --with-compiledby=shlian --with-python3-command=python3

如果上述配置命令配置、编译后，vim一直不能支持python3，则建议尝试一下下面的命令：

./configure --prefix=/usr --enable-luainterp=yes --enable-mzschemeinterp --enable-perlinterp=yes --enable-python3interp=yes --enable-tclinterp=yes --enable-rubyinterp=yes --enable-cscope --enable-terminal --enable-autoservername --enable-multibyte --enable-xim --enable-fontset --with-modified-by=shlian --with-compiledby=shlian --with-python3-config-dir=/usr/lib/python3.8/config-3.8-x86_64-linux-gnu

#上面的--with-python3-config-dir的目录视机器的不同而不同，建议在自己的机器上查找具体的配置目录并修改。

说明：

1、标红的非常关键， vim8.2以后的版本，在配置的时候，不用再指定python的config目录了（网上很多很多指定python的config目录的教程，只能说已经过时了，详见：./configure --help)

2、注意：vim8.2以后的版本不支持同时使用python2和python3，所以千万不可以在上述命令中指定：--enable-pythoninterp=yes，否则python3不会被vim支持的

3、如果发现了错误，则安装不存在的依赖包：

3.1 yum install perl-devel #让vim支持perl解释器

3.2 yum install perl-ExtUtils-Embed #安装包解决：找不到EXTERN.h文件的问题

3.3 yum install ruby-devel #让vim支持ruby解释器

3.4 如果系统已经有自带的python3.6及以上版本了，建议先安装一下python3-devel(ubuntu:sudo apt-get install python3-dev)

4、配置阶段检查python3-dev是否能找到：

执行上面的 ./configure 命令，检查python相关的输出：

可以找到 python3的配置目录和libpython3.8.so.1.0的库，说明配置没有问题，可以make了。

5、构建及安装：make -j 8 && sudo make install

6、构建完成后，vim会存放在vim/src/目录，可以在这个目录运行一下 vim --version查看是否已经出现了“+python3"，然后再安装；如果安装后还是没有带现"+python3"，那么可能在你的电脑上存在多个版本的vim，请统一版本或修改path之后，再试。

7、查看vim是否支持python3：

带+号的说明已经支持了，所以，已经成功安装了支持python3的vim

三、安装vim辅助插件

1、下载管理插件的插件——vundle

新建目录： mkdir -p ~/.vim/bundle

clone代码：git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim

2、在home目录，新建一个.vimrc文件，并输入以下内容：

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()
 
" let Vundle manage Vundle, required
Plugin 'VundleVim/Vundle.vim'
 
" All of your Plugins must be added before the following line
call vundle#end()            " required
filetype plugin indent on    " required

3、安装

使用vim打开.vimrc文件： vim .vimrc

按键”shift+;"进入命令模式，输入:PluginInstall，然后回车即可完成安装

4、配置.vimrc，是一项很复杂的工作，我配置好的如下(已经安装了很多插件了，如：文件搜索、注释、doxygen、drawit、buffer、winmanager+taglist+tagbar等等）：

"/**
"* @file .vimrc
"* @brief vimrc
"* @author shlian
"* @version 1.1.1
"* @date 2022-04-19
"*/
set nocompatible " 关闭 vi 兼容模式
set smartindent "当在大括号中间回车的时候，他会智能缩进，因为他知道括号中间要缩进
set tabstop=2
set shiftwidth=2
set expandtab
syntax on " 自动语法高亮
set number " 显示行号
"设置代码参考线
highlight ColorColumn ctermbg=darkgray
set colorcolumn=140
set t_ti= t_te=
 
" 高亮显示当前行
set cursorline 
  "red（红），white（白），black（黑），green（绿），yellow（黄），blue（蓝），purple（紫），gray（灰），brown（棕），tan(褐色)，syan(青色)
hi CursorLine   cterm=NONE ctermbg=darkgray ctermfg=NONE
"hi CursorColumn cterm=NONE ctermbg=darkred ctermfg=white 
set ruler " 打开状态栏标尺
set shiftwidth=2 " 设定 << 和 >> 命令移动时的宽度为 4
set softtabstop=2 " 使得按退格键时可以一次删掉 4 个空格
set tabstop=2 " 设定 tab 长度为 4
set nobackup " 覆盖文件时不备份
"set autochdir " 自动切换当前目录为当前文件所在的目录
set backupcopy=yes " 设置备份时的行为为覆盖
set ignorecase smartcase " 搜索时忽略大小写，但在有一个或以上大写字母时仍保持对大小写敏感
set nowrapscan " 禁止在搜索到文件两端时重新搜索
set incsearch " 输入搜索内容时就显示搜索结果
set hlsearch " 搜索时高亮显示被找到的文本
set noerrorbells " 关闭错误信息响铃
set novisualbell " 关闭使用可视响铃代替呼叫
set t_vb= " 置空错误铃声的终端代码
set showmatch " 插入括号时，短暂地跳转到匹配的对应括号
" set matchtime=2 " 短暂跳转到匹配括号的时间
set magic " 设置魔术
set hidden " 允许在有未保存的修改时切换缓冲区，此时的修改由 vim 负责保存
set guioptions-=T " 隐藏工具栏
set guioptions-=m " 隐藏菜单栏
set smartindent " 开启新行时使用智能自动缩进
set backspace=indent,eol,start
" 不设定在插入状态无法用退格键和 Delete 键删除回车符
set cmdheight=1 " 设定命令行的行数为 1
set laststatus=2 " 显示状态栏 (默认值为 1, 无法显示状态栏)
set statusline=\ %<%F[%1*%M%*%n%R%H]%=\ %y\ %0(%{&fileformat}\ %{&encoding}\ %c:%l/%L%)\
 
" 设置在状态行显示的信息
set foldenable " 开启折叠
set foldmethod=syntax " 设置语法折叠************************
set foldcolumn=0 " 设置折叠区域的宽度
setlocal foldlevel=1 " 设置折叠层数为
"set foldclose=all " 设置为自动关闭折叠 
nnoremap <space> @=((foldclosed(line('.')) < 0) ? 'zc' : 'zo')<CR>
" 用空格键来开关折叠
" return OS type, eg: windows, or linux, mac, et.st..
function! MySys()
    if has("win16") || has("win32") || has("win64") || has("win95")
        return "windows"
    elseif has("unix")
        return "linux"
    endif
endfunction
 
" 用户目录变量$VIMFILES
if MySys() == "windows"
    let $VIMFILES = $VIM.'/vimfiles'
elseif MySys() == "linux"
    let $VIMFILES = $HOME.'/.vim'
endif
" 设定doc文档目录
let helptags=$VIMFILES.'/doc'
 
" 设置字体 以及中文支持
if has("win32")
    set guifont=Inconsolata:h12:cANSI
endif
" 配置多语言环境
if has("multi_byte")
" UTF-8 编码
set encoding=utf-8
set termencoding=utf-8
set formatoptions+=mM
set fencs=utf-8,gbk
if v:lang =~? '^\(zh\)\|\(ja\)\|\(ko\)'
    set ambiwidth=double
endif
if has("win32")
    source $VIMRUNTIME/delmenu.vim
    source $VIMRUNTIME/menu.vim
    language messages zh_CN.utf-8
endif
else
    echoerr "Sorry, this version of (g)vim was not compiled with +multi_byte"
endif
" Buffers操作快捷方式!
"nnoremap <C-RETURN> :bnext<CR>
"nnoremap <C-S-RETURN> :bprevious<CR>
 
" Tab操作快捷方式!
"nnoremap <C-TAB> :tabnext<CR>
"nnoremap <C-S-TAB> :tabprev<CR>
"关于tab的快捷键
" nnoremap tn :tabnext<cr>
" nnoremap tp :tabprevious<cr>
" nnoremap td :tabnew .<cr>
" nnoremap te :tabedit
" nnoremap tc :tabclose<cr>
"窗口分割时,进行切换的按键热键需要连接两次,比如从下方窗口移动
"光标到上方窗口,需要<c-w><c-w>k,非常麻烦,现在重映射为<c-k>,切换的
"时候会变得非常方便.
nnoremap <C-h> <C-w>h
nnoremap <C-j> <C-w>j
nnoremap <C-k> <C-w>k
nnoremap <C-l> <C-w>l
 
" set fileformats=unix,dos,mac
 nnoremap <leader>fd :se fileformat=dos<CR>
 nnoremap <leader>fu :se fileformat=unix<CR>
" use Ctrl+[l|n|p|cc] to list|next|previous|jump to count the result
" nnoremap <C-x>l <ESC>:cl<CR>
" nnoremap <C-x>n <ESC>:cn<CR>
" nnoremap <C-x>p <ESC>:cp<CR>
" nnoremap <C-x>c <ESC>:cc<CR>
 
 
" Python 文件的一般设置，比如不要 tab 等
autocmd FileType python set tabstop=4 shiftwidth=4 expandtab
autocmd FileType python map <F12> :!python %<CR>
" 选中状态下 Ctrl+c 复制
"vmap <C-c> "+y
 
"十六进制显示文件 
nnoremap <leader>H :%!xxd<CR>     
"二进制显示文件
nnoremap <leader>B :%!xxd -r<CR>
 
"******************************************************************************************************************
set rtp+=~/.vim/bundle/Vundle.vim
call vundle#begin()
	filetype plugin indent on    " 必须加载vim自带和插件相应的语法和文件类型相关脚本
 
	"vim包管理工具
	Plugin 'gmarik/Vundle.vim'
	"文件目录增加git 状态
	Plugin 'Xuyuanp/nerdtree-git-plugin'
	
	"tab智能补全
	Plugin 'ervandew/supertab'
	"代码可视化缩进块
    Plugin 'yggdroot/indentline'
        let g:indentLine_enabled = 1
        let g:indentLine_color_term = 230
        "let g:indentLine_char_list = ['|', '¦', '┆', '┊','|'] 会出现光标的错行，慎用
        let g:indentLine_char_list = ['|', '¦', '¦', '¦']
	"彩虹括号
	Plugin 'kien/rainbow_parentheses.vim'
 
	"真彩色
	Plugin 'tpope/vim-sensible'
	"git左边栏增删改提示
	Plugin 'airblade/vim-gitgutter'
 
    Plugin 'altercation/solarized'
	Plugin 'altercation/vim-colors-solarized'  "solarized
	    let g:solarized_termtrans  = 1         " 使用 termnal 背景
	    let g:solarized_visibility = "high"    " 使用 :set list 显示特殊字符时的高亮级别
	    " GUI 模式浅色背景，终端模式深色背景
	    if has('gui_running')
			set background=light
	    else
			set background=dark
	    endif
	    " 主题设置为 solarized
		"colorscheme solarized
 
	"文件目录分屏
	Plugin 'scrooloose/nerdtree'
		let NERDTreeHighlightCursorline = 1       " 高亮当前行
		let NERDTreeShowLineNumbers     = 1       " 显示行号
		" 忽略列表中的文件
		let NERDTreeIgnore = [ '\.pyc$', '\.pyo$', '\.obj$', '\.o$', '\.egg$', '^\.git$', '^\.repo$', '^\.svn$', '^\.hg$' ]
		" 启动 vim 时打开 NERDTree
		"autocmd vimenter * NERDTree
		" 当打开 VIM，没有指定文件时和打开一个目录时，打开 NERDTree
		"autocmd StdinReadPre * let s:std_in = 1
		"autocmd VimEnter * if argc() == 0 && !exists("s:std_in") | NERDTree | endif
		"autocmd VimEnter * if argc() == 1 && isdirectory(argv()[0]) && !exists("s:std_in") | exe 'NERDTree' argv()[0] | wincmd p | ene | exe 'cd '.argv()[0] | endif
		" 关闭 NERDTree，当没有文件打开的时候
		"autocmd bufenter * if (winnr("$") == 1 && exists("b:NERDTreeType") && b:NERDTreeType == "primary") | q | end
        
		" <leader>nt 打开 nerdtree 窗口，在左侧栏显示
		nnoremap <leader>nt :NERDTreeToggle<CR>
		" <leader>tc 关闭当前的 tab
		nnoremap <leader>tc :tabc<CR>
		" <leader>to 关闭所有其他的 tab
		nnoremap <leader>to :tabo<CR>
		" <leader>ts 查看所有打开的 tab
		nnoremap <leader>ts :tabs<CR>
		" <leader>tp 前一个 tab
		nnoremap <leader>tp :tabp<CR>
		" <leader>tn 后一个 tab
		nnoremap <leader>tn :tabn<CR
 
    "tagbar
    Plugin 'majutsushi/tagbar'
        let g:tagbar_ctags_bin = 'ctags' " tagbar 依赖 ctags 插件
        let g:tagbar_width     = 30      " 设置 tagbar 的宽度为 30 列，默认 40 列
        let g:tagbar_autofocus = 1       " 打开 tagbar 时光标在 tagbar 页面内，默认在 vim 打开的文件内
        let g:tagbar_left      = 1       " 让 tagbar 在页面左侧显示，默认右边
        "let g:tagbar_sort      = 0       " 标签不排序，默认排序
         
        " <leader>tb 打开 tagbar 窗口，在左侧栏显示
        nnoremap <leader>tb :TagbarToggle<CR>
 
    "taglist
    Plugin 'vim-scripts/taglist.vim'
        let Tlist_Show_One_File           = 1    " 只显示当前文件的tags
        let Tlist_GainFocus_On_ToggleOpen = 1    " 打开 Tlist 窗口时，光标跳到 Tlist 窗口
        let Tlist_Exit_OnlyWindow         = 1    " 如果 Tlist 窗口是最后一个窗口则退出 Vim
        let Tlist_Use_Left_Window         = 1    " 在左侧窗口中显示
        let Tlist_File_Fold_Auto_Close    = 1    " 自动折叠
        let Tlist_Auto_Update             = 1    " 自动更新
         
        " <leader>tl 打开 Tlist 窗口，在左侧栏显示
         nnoremap <leader>tl :TlistToggle<CR>
 
    "winmanager
    Plugin 'vim-scripts/winmanager'
        let g:NERDTree_title="[NERDTree]"
        "let g:winManagerWindowLayout="TagList|NERDTree"
        let g:winManagerWindowLayout='FileExplorer|TagList'
 
        function! NERDTree_Start()
            exec 'NERDTree'
        endfunction
        function! NERDTree_IsValid()
            return 1
        endfunction
 
        nnoremap wm :WMToggle<CR>
 
    "powerline fonts
    Plugin 'powerline/powerline-fonts'
    "状态栏
    Plugin 'vim-airline/vim-airline'
    Plugin 'vim-airline/vim-airline-themes'
 
        let g:airline_powerline_fonts = 1   " 使用powerline打过补丁的字体
        if !exists('g:airline_symbols')
            let g:airline_symbols = {}
        endif
        " 关闭当前 buffer
        "noremap <C-x> :w<CR>:bd<CR>
        "<leader>1~9 切到 buffer1~9
        nnoremap <leader>1 :b 1<CR>
        nnoremap <leader>2 :b 2<CR>
        nnoremap <leader>3 :b 3<CR>
        nnoremap <leader>4 :b 4<CR>
        nnoremap <leader>5 :b 5<CR>
        nnoremap <leader>6 :b 6<CR>
        nnoremap <leader>7 :b 7<CR>
        nnoremap <leader>8 :b 8<CR>
        nnoremap <leader>9 :b 9<CR>
 
        "Vim 在与屏幕/键盘交互时使用的编码(取决于实际的终端的设定)        
        set encoding=utf-8
        set langmenu=zh_CN.UTF-8
        " 设置打开文件的编码格式  
        set fileencodings=ucs-bom,utf-8,cp936,gb18030,big5,euc-jp,euc-kr,latin1 
        set fileencoding=utf-8
        " 解决菜单乱码
        source $VIMRUNTIME/delmenu.vim
        source $VIMRUNTIME/menu.vim
        " 解决consle输出乱码
        "set termencoding = cp936  
        " 设置中文提示
        "language messages zh_CN.utf-8 
        " 设置中文帮助
        set helplang=cn
        " 设置为双字宽显示，否则无法完整显示如:☆
        set ambiwidth=double
        " 总是显示状态栏 
        let laststatus = 2
        let g:airline_theme='solarized'      " 设置主题,simple、dark、solarized、bubblegum 详见.vim/bundle/vim-airline-themes
 
        " 开启tabline
        let g:airline#extensions#tabline#enabled = 1      "tabline中当前
        let g:airline#extensions#tabline#left_sep = ' '   "buffer两端的分隔字符
        let g:airline#extensions#tabline#left_alt_sep = '|'      "tabline中
        let g:airline#extensions#tabline#buffer_nr_show = 1      "buffer显示编号
 
        let g:airline_left_sep = ' '
        let g:airline_left_alt_sep = '▶'
        let g:airline_right_sep = ' '
        let g:airline_right_alt_sep = '◀'
        let g:airline_symbols.crypt = '🔒'
        let g:airline_symbols.linenr = '¶'
        let g:airline_symbols.maxlinenr = '㏑'
        let g:airline_symbols.branch = '⎇'
        let g:airline_symbols.paste = 'ρ'
        let g:airline_symbols.spell = 'Ꞩ'
        let g:airline_symbols.notexists = 'Ɇ'
        let g:airline_symbols.whitespace = 'Ξ'
 
        " 映射切换buffer的键位
        nnoremap [b :bp<CR>
        nnoremap ]b :bn<CR>
        " 设置字体 
        set guifont=Powerline_Consolas:h14:cANSI
 
    Plugin 'enricobacis/vim-airline-clock'
        "let g:airline#extensions#clock#auto = 0  关闭
        let g:airline#extensions#clock#format = '%H:%M:%S'
    
    ""代码动态检查(使用YCM自带的即可)
    "Plugin 'w0rp/ale'
    "    let g:ale_lint_on_text_changed       = 'normal'                     " 代码更改后启动检查 
    "    let g:ale_lint_on_insert_leave       = 1                            " 退出插入模式即检查
    "    let g:ale_sign_column_always         = 1                            " 总是显示动态检查结果
    "    "let g:ale_statusline_format = ['✗ %d', '⚡%d','✔  OK']
    "    let g:ale_sign_error                 = '>>'                         " error 告警符号
    "    let g:ale_sign_warning               = '--'                         " warning 告警符号
    "    let g:ale_echo_msg_error_str         = 'E'                          " 错误显示字符
    "    let g:ale_echo_msg_warning_str       = 'W'                          " 警告显示字符
    "    let g:ale_echo_msg_format            = '[%linter%] %s [%severity%]' " 告警显示格式
    "     
    "    " C 语言配置检查参数
    "    let g:ale_c_gcc_options              = '-Wall -Werror -O2 -std=c11'
    "    let g:ale_c_clang_options            = '-Wall -Werror -O2 -std=c11'
    "    let g:ale_c_cppcheck_options         = ''
    "    " C++ 配置检查参数
    "    let g:ale_cpp_gcc_options            = '-Wall -Werror -O2 -std=c++14'
    "    let g:ale_cpp_clang_options          = '-Wall -Werror -O2 -std=c++14'
    "    let g:ale_cpp_cppcheck_options       = ''
    "     
    "    "使用clang对c和c++进行语法检查，对python使用pyli