【玩转Lighthouse】在Lighthouse配置Vim的YouCompleteMe：文本编辑更清爽和强大，并具有一定的IDE能力

原创

Mintimate

发布于 2022-04-22 10:05:50

1.8K6

发布于 2022-04-22 10:05:50

文章被收录于专栏：Mintimate's BlogMintimate's Blog

作者：Mintimate

博客：https://www.mintimate.cn Mintimate's Blog，只为与你分享

Vim&YCM

Vim的强大已经是毋庸置疑了。并且开源社区内大佬们十分活跃，满满的安全感^_^。本文将介绍Vim如何编译安装，并支援Python，进而安装号称最难安装的Vim插件：YouCompleteMe。以下为了方便，我简称为：YCM。配合它，可以让你的Vim文本编辑更强大和清爽，并具有一定的IDE能力。不能说完全媲美IDE，但是也算多了个不错的工具啦。

当然，如果你喜欢用emacs，同样十分OK啦。

Vim

Vim的安装和使用，我在之前的文章就已经介绍：

终端文本编辑神器--Vim命令详解。如何配置Vim以及Vim插件?

YCM

项目的地址，其实已经说得很详细，比如：

It has several completion engines built in and supports any protocol-compliant Language Server, so can work with practically any language.

之所以号称最难安装的Vim插件…… 我觉得主要是两个原因：

需要重新编译Vim并支援Python（推荐支援Py3）。
国内需要处理网络问题。

不过，本文都会帮你解决上述问题。不用担心啦～～

安装逻辑：

准备工具

嗯…… 只是配置一个Vim插件罢了…… 所以需要的工具：

服务器：一台Lighthouse（Linux系统，e.g. Debian、CentOS）

Windwos虽然也有Vim，但是我个人用Windows比较少，加上我没有Windows Server的服务器。这里不做演示。

我这里主要演示Lighthouse的Debian和CentOS镜像，其他基于上述进行的应用镜像也可以按我的操作（如：SRS应用镜像、Wordpress应用镜像等）。

编译Vim

首先，我们SSH登录我们的Lighthouse服务器，如果不知道怎么SSH连接服务器，可以参考文章：

Linux服务器入门：如何远程登录自己的腾讯云服务器？

查看Vim版本：

vim -v

目前（2022.04）Lighthouse自带的Vim版本为8.1.1401；但是查看YCM的官网，目前最新YCM支援的版本为8.1.2269：

所以，我们需要安装新版本的Vim。本文使用的方法是编译新版本Vim。

克隆Vim源码

首先，我们使用Git克隆Vim的最新源码，或者是分支版本。Vim的官方项目仓库地址：

https://github.com/vim/vim.git

这里我直接克隆最新master分支：

# 创建一个目录，方便管理
mkdir ~/myApplications/Source -p
# 进入目录
cd ~/myApplications/Source
# 克隆Vim源码
git clone https://github.com/vim/vim.git

支援Python3

在编译安装Vim前，我们需要配置Python3，使其后续Vim能支援到Python3。方法很多，这里选择最简单的方法：软件包安装Python3和Python3-dev：

sudo apt install python3
sudo apt install python3-dev

支援Ruby（可选）

为了让我们的Vim也支援Ruby，我有时候会那Vim去编辑Reby。我们也事先用软件包安装一下：

sudo apt install ruby-dev -y

configure配置

根据源码内configure的配置选项：

我们支援Python3和Ruby，并安装到/usr/local/vim（系统自带的vim保留着没动）：

./configure \
--with-features=huge \
--prefix=/usr/local/vim \
--with-features=huge \
--enable-rubyinterp \
--enable-fail-if-missing \
–-enable-luainterp \
–-enable-perlinterp \
–-enable-fontset \
--enable-python3interp \
--with-python3-command=python3

等configure配置结束，我们就可以进行编译和安装。

需要注意：

不要支援Python2，否则YCM会无法调取Python（嗯…… 主要是难操作）

编译和安装

接下来我们开始编译和安装，我的Lighthouse是两个CPU，所以设置使用多线程编译：

sudo make -j2

Lighthouse的CPU性能强劲，配置个几十秒就好了。

之后是安装：

sudo make install

之后，查看我们的编译安装地址，即可发现我们编译安装的vim：

最后，我们配置到用户环境变量：

# 对用户环境变量进行追加
echo 'export PATH="/usr/local/vim/bin:$PATH"' >> ~/.bashrc
# 重载环境变量
source ~/.bashrc

最后，查看Vim的版本，就是最新版本的Vim了：

并且，Python成功支援到：

vim --version | grep python

Vim安装vim-plug

我们要安装YCM插件，手动配置是很麻烦的。所以，我们借助vim-plug去激活并管理我们的YCM插件（以及其他插件）。安装方法很简单。

在终端内：

# 创建vim插件目录
mkdir  ~/.vim/autoload -p
# 进入其中
cd  ~/.vim/autoload
# 下载vim-plug脚本
wget https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
# GitHub连接不上，可以用jsdelivr
wget https://cdn.jsdelivr.net/gh/junegunn/vim-plug@master/plug.vim

如果vim-plug脚本因为网络问题下载不下来，可以本地下载后，拷贝里面内容并手动在Lighthouse上创建。

Plug换源

因为vim-plug默认使用GitHub作为插件的抓去地址，但是因为一些原因，中国大陆连接GitHub有点困难大家可以根据自己网络环境，选择换源。

换源的方法很简单，编辑我们刚刚下载的plug.vim文件：

vim  ~/.vim/autoload/plug.vim

搜索plug_url_format和git::@github,更改：

let fmt = get(g:, 'plug_url_format', 'https://git::@github.com/%s.git')
\ '^https://git::@github\.com', 'https://github.com', '')

为

let fmt = get(g:, 'plug_url_format', 'https://git::@hub.fastgit.xyz/%s.git')
\ '^https://git::@hub.fastgit\.xyz', 'https://hub.fastgit.xyz', '')

具体可以参考我以前写的教程：

终端文本编辑神器--Vim命令详解。如何配置Vim以及Vim插件？

为了让接下来的YCM能直接Git clone下来附加仓库，我们设置一下GitHub全局重定向：

git config --global url."https://hub.fastgit.xyz/".insteadOf "https://github.com/"
git config --global protocol.https.allow always

这里使用的Fastgit对GitHub仓库进行重定向，如果Fastgit无法使用（也就是后续还是卡了），可以试试其他GitHub重定向。有机会和大家说说怎么自建GitHub加速API(*≧ω≦)。

安装YCM

现在，我们可以借助vim-plug，给Lighthouse上的Vim安装YCM。编辑.vimrc文件，添加YCM的项目地址：

# 编辑.vimrc文件
vim ~/.vimrc

追加：

" 使用vim-plug添加插件
call plug#begin('~/.vim/plugged')
"" 添加YCM插件
Plug 'ycm-core/YouCompleteMe'
call plug#end()

之后，保存并退出后，再次进入.vimrc后，执行:PlugInstall：

在主仓库下载后，vim-plug会帮YCM根据.gitmodule递归下载其附加仓库，比如：

如果卡某个仓库，比如：卡在下载mrab-regex：

手动帮它Git clone，先直接Ctrl+C终止git：

之后，退出vim交互后，手动克隆子模块：

这里mrab-regex是私人仓库，但是GitHub上也有仓库：https://github.com/mrabarnett/mrab-regex。我们使用GitHub上的代替，并继续YCM初始化：

# 进入YCM文件夹
cd ~/.vim/plugged/YouCompleteMe
# 子仓库继续克隆
git submodule update --init --recursive

最后，子仓库克隆结束，YCM前期仓库准备结束：

初始化

现在，我们需要进一步的安装，也就是初始化。进入YCM插件目录：

cd ~/.vim/plugged/YouCompleteMe

根据YCM项目官网介绍的编译参数：

执行：

python3 install.py --rust-completer --cs-completer --verbose

其中：

--rust-completer：支援Ruby；
--cs-completer：支援C++/C；
--verbose：启动详情日志输出；

本来我还想支援Java的…… 但是一是需要再配置JAVA_HOME，文章太长了……；二是，我平常还是用IDEA编辑Java比较多(･_･;

如果出现Cmake版本缺失或版本太低：

可以到cmake项目地址：https://cmake.org/download/，下载cmake并配置。比如：我配置cmake3.23.1

# 下载cmake预编译版本
wget https://cdn.jsdelivr.net/gh/Kitware/CMake@releases/download/v3.23.1/cmake-3.23.1-linux-x86_64.tar.gz
# 解压归档文件
tar -xf cmake-3.23.1-linux-x86_64.tar.gz
# 将解压出的cmake移动到/usr/local，并重命名
mv cmake-3.23.1-linux-x86_64 /usr/local/cmake3.23.1
# 环境变量追加
echo 'export PATH=/usr/local/cmake3.23.1/bin:$PATH' >> ~/.bashrc
# 重载环境变量
source ~/.bashrc

之后，回到YCM插件目录，执行安装脚本：

cd ~/.vim/plugged/YouCompleteMe
python3 install.py --rust-completer --cs-completer --verbose

但是，如果你的Lighthouse，是大陆服务器且碰巧无法连接GitHub，这里会卡住的话：

这个时候，又要祭出换源大法了◡ ヽ(`Д´)ﾉ ┻━┻

观察YCM源码脚本可以知道，这个脚本写在：YCM插件模块/third_party/ycmd/build.py内，我们编辑这个文件：

# 当前在YCM模块内
vim third_party/ycmd/build.py

查找关键词：github，把文件下载地址改成自己Lighthouse可以直接连接到的地址即可：

我是本地上次后，上传到我网站里并作为直链了。大家可以想想办法提供直接连接（比如：对象存储桶公开直链、Coding中继等）。

之后，继续安装：

到此，我们的YCM就安装完成了。接下来是配置了。

配置YCM

给大家分享一下我的YCM配置，在.vimrc内添加YCM全局配置：

let g:ycm_global_ycm_extra_conf='~/.vim/.ycm_extra_conf.py'
" 开启 YCM 基于标签引擎
let g:ycm_collect_identifiers_from_tags_files=1
" 从第2个键入字符就开始罗列匹配项
let g:ycm_min_num_of_chars_for_completion=2
" 禁止缓存匹配项,每次都重新生成匹配项
let g:ycm_cache_omnifunc=0
" 语法关键字补全
let g:ycm_seed_identifiers_with_syntax=1

之后，保存并退出。我们随便打开一个Python文件（普通文件也可以……），就可以自动代码提示和补全了：

额外插件

最后，再推荐插件：

pangloss/vim-javascript：支援Vim，使Vim支持JavaScript的语法高亮和代码格式化。
kien/rainbow_parentheses.vim：支援Vim，使Vim编辑文件内的括号，变为“彩虹色”。
preservim/nerdtree：支援Vim，使Vim可以出现IDE的目录结构。

安装方法很简单，同样适用vim-plug帮我们引用：

Plug 'preservim/nerdtree'
Plug 'kien/rainbow_parentheses.vim'
Plug 'pangloss/vim-javascript'

之后，和刚刚一样：保存并退出，之后重新进入并执行：PlugInstall：

最后，再追加配置：

" nerdtree配置
autocmd StdinReadPre * let s:std_in=1
autocmd VimEnter * NERDTree | if argc() > 0 || exists("s:std_in") | wincmd p | endif
autocmd BufEnter * if tabpagenr('$') == 1 && winnr('$') == 1 && exists('b:NERDTree') && b:NERDTree.isTabTree() | quit | endif

" RGB彩色括号
let g:rbpt_colorpairs = [
    \ ['brown',       'RoyalBlue3'],
    \ ['Darkblue',    'SeaGreen3'],
    \ ['darkgray',    'DarkOrchid3'],
    \ ['darkgreen',   'firebrick3'],
    \ ['darkcyan',    'RoyalBlue3'],
    \ ['darkred',     'SeaGreen3'],
    \ ['darkmagenta', 'DarkOrchid3'],
    \ ['brown',       'firebrick3'],
    \ ['gray',        'RoyalBlue3'],
    \ ['black',       'SeaGreen3'],
    \ ['darkmagenta', 'DarkOrchid3'],
    \ ['Darkblue',    'firebrick3'],
    \ ['darkgreen',   'RoyalBlue3'],
    \ ['darkcyan',    'SeaGreen3'],
    \ ['darkred',     'DarkOrchid3'],
    \ ['red',         'firebrick3'],
    \ ]
let g:rbpt_max = 16
let g:rbpt_loadcmd_toggle = 0
au VimEnter * RainbowParenthesesToggle
au Syntax * RainbowParenthesesLoadRound
au Syntax * RainbowParenthesesLoadSquare
au Syntax * RainbowParenthesesLoadBraces

保存并退出，即可看到效果：

这样，Vim就具备一定的 IDE功能了。

END

到此，YouCompleteMe和它的“好朋友们”就安装并配置完成了。

你也可以配合ZSH，获得更好的Shell体验：

参考教程：

Linux/Mac通过Oh-my-zsh配置Zsh插件，让你的终端更加强大且智能

有些人可能会说，用Vscode、IDEA之类的编辑器或者集成开发工具不好么？当然好，而且很方便；但是Vim安装YCM，是让你的Vim支持更多功能；有时候，我们可能需要修改Python脚本内某些数据，直接在Lighthouse服务器上用Vim就可以直接操作，亦或者直接编辑Nginx文件，还是挺方便的。

多一个方法，多条路；可不是让你丢弃开发环境，全部使用Vim进行开发哦。