300字范文 > 从零开始vim搭建Java开发环境之coc.nvim 篇

从零开始vim搭建Java开发环境之coc.nvim 篇

时间：2022-10-01 22:35:33

前言

vim之美妙我就不过多介绍了，懂的自然懂。之前我已经有一篇文章介绍如何使用SpaceVim来搭建Java开发环境。

传送门：《从零开始vim搭建Java开发环境[视频]》

最近使用coc.nvim,感觉体验也很棒，与是就想使用coc.nvim平台也来搭建个Java开发环境，来比较一下哪个更适合自己。

环境

搭建环境千差万别，大同小异，理论上各大平台都是支持的，我把我的环境发一下仅供参考。

环境搭建

我们的主题就是用vim搭建Java开发环境，第一步当然是安装vim了，很多系统默认自带的vim是精简版本的，或者版本比较旧。建议自己安装一个，比如：macOS自带的vim就不支持python3，之前因为这个坑研究了好久才明白。

安装vim

安装vim或neovim都是可以的，上篇中我使用的neovim，这篇打算使用vim来搭建了。

sudo pacman -S vim

查询是否支持python3

vim --version

显示结果中如果有+python3字样就说明是支持的了。

这里需要注意一下，为了少走弯路，你安装的vim版本最好要有python3支持，因为我遇到过很多插件都需要这个。在archlinux中安装后默认就支持python3了。其他系统可以自行百度一下，如何让vim/neovim有python3支持。下列文章供参考：

《Centos安装nvim并支持python3》

/lxyoucan/article/details/114309132《CentOS 安装vim8 + python3》

/lxyoucan/article/details/114274117《archlinux 安装neovim并增加python3支持》

/lxyoucan/article/details/115280569《macOS中SpaceVim搭建java开发环境》

/lxyoucan/article/details/113873596

安装vim-plug

软件管理器还是需要一个的，我们就使用coc.nvim演示中使用的vim-plug来管理插件吧。

项目主页：

/junegunn/vim-plug

Unix中vim环境执行下面命令完成安装，其他环境请参考项目主页的介绍。

curl -fLo ~/.vim/autoload/plug.vim --create-dirs \/junegunn/vim-plug/master/plug.vim

成功执行，就已经安装完成了。后面我们安装vim插件需要vim-plug。

安装node.js

coc.nvim依赖node.js而且版本要求nodejs >= 10.12。

archlinux下执行：

sudo pacman -S nodejssudo pacman -S npm

其他系统环境请参考：/

查node.js版本

node -vv15.13.0

安装coc.nvim

终于轮到今天的主角了。看了一下贡献者中前几个是国内的大佬，在此膜拜一下。

项目地址：

/neoclide/coc.nvim

安装很简单。

配置vim的配置文件

vim ~/.vimrc

内容如下：

" Specify a directory for plugins" - For Neovim: stdpath('data') . '/plugged'" - Avoid using standard Vim directory names like 'plugin'call plug#begin('~/.vim/plugged')" Use release branch (recommend)Plug 'neoclide/coc.nvim', {'branch': 'release'}call plug#end()

:wq保存退出，重启打开vim后，执行:PlugInstall完成插件的安装。

编辑配置文件

vim ~/.vimrc

并在~/.vimrc下面增加如下内容：

" 设置vim的内部编码，在neovim上不需要，因为coc.nvim使用了一些" autoload / float.vim文件中的unicode字符set encoding=utf-8" 如果未设置“隐藏”，则TextEdit可能会失败。set hidden" 某些服务器的备份文件有问题，请参阅＃649。set nobackupset nowritebackup" 留出更多空间来显示消息。set cmdheight=2" 较长的更新时间（默认值为4000 ms = 4 s）会导致明显的" 延迟和糟糕的用户体验。set updatetime=300" 不要将消息传递到| ins-completion-menu |。set shortmess+=c" 始终显示标志列，否则每次都会移动文本" 诊断出现/已解决。if has("patch-8.1.1564")" 最近vim可以将signcolumn和number列合并为一个set signcolumn=numberelseset signcolumn=yesendif" 使用制表符可完成带有前面字符的触发操作并进行导航。" NOTE: 这个命令':verbose imap <tab>' 去确实你的<tab>键" 没有被其他插件使用。inoremap <silent><expr> <TAB>\ pumvisible() ? "\<C-n>" :\ <SID>check_back_space() ? "\<TAB>" :\ coc#refresh()inoremap <expr><S-TAB> pumvisible() ? "\<C-p>" : "\<C-h>"function! s:check_back_space() abortlet col = col('.') - 1return !col || getline('.')[col - 1] =~# '\s'endfunction" 使用 <c-space> 触发自动完成。if has('nvim')inoremap <silent><expr> <c-space> coc#refresh()elseinoremap <silent><expr> <c-@> coc#refresh()endif" 使<CR>自动选择第一个完成项目，并将coc.nvim通知给" 输入格式，<cr>可能会被其他vim插件重新映射inoremap <silent><expr> <cr> pumvisible() ? coc#_select_confirm()\: "\<C-g>u\<CR>\<c-r>=coc#on_enter()\<CR>"" 使用 `[g` and `]g` 浏览诊断" Use `:CocDiagnostics` to get all diagnostics of current buffer in location list.nmap <silent> [g <Plug>(coc-diagnostic-prev)nmap <silent> ]g <Plug>(coc-diagnostic-next)" GoTo代码导航nmap <silent> gd <Plug>(coc-definition)nmap <silent> gy <Plug>(coc-type-definition)nmap <silent> gi <Plug>(coc-implementation)nmap <silent> gr <Plug>(coc-references)" 使用 K 在预览窗口中显示文档。nnoremap <silent> K :call <SID>show_documentation()<CR>function! s:show_documentation()if (index(['vim','help'], &filetype) >= 0)execute 'h '.expand('<cword>')elseif (coc#rpc#ready())call CocActionAsync('doHover')elseexecute '!' . &keywordprg . " " . expand('<cword>')endifendfunction" 按住光标时突出显示该符号及其参考。autocmd CursorHold * silent call CocActionAsync('highlight')" 重命名符号。nmap <leader>rn <Plug>(coc-rename)" 格式化选定的代码。xmap <leader>f <Plug>(coc-format-selected)nmap <leader>f <Plug>(coc-format-selected)augroup mygroupautocmd!" Setup formatexpr specified filetype(s).autocmd FileType typescript,json setl formatexpr=CocAction('formatSelected')" 更新有关跳转占位符的签名帮助。autocmd User CocJumpPlaceholder call CocActionAsync('showSignatureHelp')augroup end" 将codeAction应用于所选区域。" Example: `<leader>aap` for current paragraphxmap <leader>a <Plug>(coc-codeaction-selected)nmap <leader>a <Plug>(coc-codeaction-selected)" 重新映射用于将codeAction应用于当前缓冲区的键。nmap <leader>ac <Plug>(coc-codeaction)" 将AutoFix应用于当前行的问题。nmap <leader>qf <Plug>(coc-fix-current)" 映射函数和类文本对象" 注意：需要语言服务器提供'textDocument.documentSymbol'支持。xmap if <Plug>(coc-funcobj-i)omap if <Plug>(coc-funcobj-i)xmap af <Plug>(coc-funcobj-a)omap af <Plug>(coc-funcobj-a)xmap ic <Plug>(coc-classobj-i)omap ic <Plug>(coc-classobj-i)xmap ac <Plug>(coc-classobj-a)omap ac <Plug>(coc-classobj-a)" Remap <C-f> and <C-b> for scroll float windows/popups.if has('nvim-0.4.0') || has('patch-8.2.0750')nnoremap <silent><nowait><expr> <C-f> coc#float#has_scroll() ? coc#float#scroll(1) : "\<C-f>"nnoremap <silent><nowait><expr> <C-b> coc#float#has_scroll() ? coc#float#scroll(0) : "\<C-b>"inoremap <silent><nowait><expr> <C-f> coc#float#has_scroll() ? "\<c-r>=coc#float#scroll(1)\<cr>" : "\<Right>"inoremap <silent><nowait><expr> <C-b> coc#float#has_scroll() ? "\<c-r>=coc#float#scroll(0)\<cr>" : "\<Left>"vnoremap <silent><nowait><expr> <C-f> coc#float#has_scroll() ? coc#float#scroll(1) : "\<C-f>"vnoremap <silent><nowait><expr> <C-b> coc#float#has_scroll() ? coc#float#scroll(0) : "\<C-b>"endif" 使用CTRL-S作为选择范围。" Requires 'textDocument/selectionRange' support of language server.nmap <silent> <C-s> <Plug>(coc-range-select)xmap <silent> <C-s> <Plug>(coc-range-select)" 添加`:Format`命令格式化当前缓冲区。command! -nargs=0 Format :call CocAction('format')" 添加`：Fold`命令来折叠当前缓冲区。command! -nargs=? Fold :callCocAction('fold', <f-args>)" Add `:OR` command for organize imports of the current mand! -nargs=0 OR :callCocAction('runCommand', 'anizeImport')" 添加（Neo）Vim的本机状态行支持。" NOTE: Please see `:h coc-status` for integrations with external plugins that" provide custom statusline: lightline.vim, vim-airline.set statusline^=%{coc#status()}%{get(b:,'coc_current_function','')}" CoCList的映射" Show all diagnostics.nnoremap <silent><nowait> <space>a :<C-u>CocList diagnostics<cr>" Manage extensions.nnoremap <silent><nowait> <space>e :<C-u>CocList extensions<cr>" Show commands.nnoremap <silent><nowait> <space>c :<C-u>CocList commands<cr>" Find symbol of current document.nnoremap <silent><nowait> <space>o :<C-u>CocList outline<cr>" Search workspace symbols.nnoremap <silent><nowait> <space>s :<C-u>CocList -I symbols<cr>" Do default action for next item.nnoremap <silent><nowait> <space>j :<C-u>CocNext<CR>" Do default action for previous item.nnoremap <silent><nowait> <space>k :<C-u>CocPrev<CR>" Resume latest coc list.nnoremap <silent><nowait> <space>p :<C-u>CocListResume<CR>

这些内容源于coc.nvim项目主页的demo，我是直接复制过来的，并对注释做了简单的翻译。

至此我们的基础环境，总算搭建好了。如果需要实现Java的开发环境还有一些路要走。

安装jdk

既然要搭建Java开发环境，JDK必不可少。这个大家应该都轻车熟路了吧。

个人建议安装jdk11，其他版本不能保证可以使用（最低Java 11是最低要求）。

sudo pacman -S jdk11-openjdk

安装coc-java

项目主页：

/neoclide/coc-java

打开vim 并执行：

:CocInstall coc-java

如果本地没有jdt.ls则会自动下载最新版本的。这个jdt.ls我这里大概20秒不到就下载完成了。

其实我第一次使用coc-java的时候就卡在了jdt.ls的下载这块，一直显示downloading,几个小时过后还是这样。后来我放弃使用coc.nvim了，改为SpaceVim。这次就很顺利（身处两个不同的城市可能网络环境不同）。如果你跟我一项目被这个jdt.ls卡住了，不防切换不同网络环境试试。

先写个HelloWorld测试一下吧，我这里测试自动补全和文档的显示都没有问题。

至此vim下搭建java开发环境就已经完成啦！

coc.nvim the java server crashed 5 times in the last 3 minutes

4月15日补

操作系统：macOS Big Sur 11.2.3

同样的操作，安装完成coc-java后打开java文件报错如下：

coc.nvim the java server crashed 5 times in the last 3 minutes. the server will not be restarted

解决办法参考：/neoclide/coc-java/issues/99
JDT Lang Sever的57版可以正常使用
/jdtls/milestones/0.57.0/
下载后解压后
替换所有目录/文件~/.config/coc/extensions/coc-java-data/server。

vim简单优化

上面已经完成啦，现在的主题和默认配置还要微调一下。

美化主题

安装插件morhetz/gruvbox

Plug 'morhetz/gruvbox'

:wq保存退出，重启打开vim后，执行:PlugInstall完成插件的安装。

并增加配置

" 使用gruvbox配色autocmd vimenter * ++nested colorscheme gruvbox" 强制使用dark模式set bg=dark

重启打开vim发现风格已经大变。

是不是比默认风格要好看多了。

还是打开刚才的java代码对比一下。

个人感觉比默认的风格更养眼。

vim-airline

提到美化，怎么能少的了vim-airline呢？

项目主页：

/vim-airline/vim-airline

插件管理中增加：

Plug 'vim-airline/vim-airline'Plug 'vim-airline/vim-airline-themes'

:wq保存退出，重启打开vim后，执行:PlugInstall完成插件的安装。

并增加配置

" vim-airlinelet g:airline#extensions#tabline#enabled = 1let g:airline_powerline_fonts = 1

看一下美化后的效果：

多了一些字体图标，看起来更时髦。不知道的还以为不是命令行程序呢。

解决乱码

如果你发现你显示的不是像我截图里的那样的，而是有乱码？之类的。那是因为字体的原因。

只要安装nerd-font字体，并设置终端模拟器的字体为nerd-font。

以macOS为例。

使用Homebrew安装nerd-font字体，顺序运行如下命令行：

brew tap homebrew/cask-fontsbrew install font-hack-nerd-font --cask

设置iterm

设置Mac自带终端。

解决SpaceVim图标在termux中乱码

字体文件下载

把这个字体文件上传到/data/data/com.termux/files/home/.termux/font.ttf目录即可解决SpaceVim 乱码的问题。

没有乱码真舒服！

其他情况，就不举例啦，不管是什么终端模拟器，只要设置好字体就可以啦。

vim配置个人习惯分享

这个是非必须的，主要还是看个人使用习惯了。

"----vim 个人使用习惯配置start------" leader设置成空格let mapleader=" "" 使用鼠标set mouse=a" 显示行号set nu" 相对行号set relativenumber" tab=4个空格set tabstop=4" 改变 vim中光标的形状let g:db_ui_use_nerd_fonts=1let &t_SI.="\e[5 q" "SI = INSERT modelet &t_SR.="\e[4 q" "SR = REPLACE modelet &t_EI.="\e[1 q" "EI = NORMAL mode (ELSE)" 高度光标所在行set cursorline" 设置不换行set nowrap" 显示按下的按键set showcmd" 按tab显示菜单set wildmenu" 插入模式移动光标inoremap <C-h> <Left>inoremap <C-j> <Down>inoremap <C-k> <Up>inoremap <C-l> <Right>inoremap <C-d> <Delete>" hh在我用的单词里出现的频率极低，其实感觉home用的没有end多，统一风格都用大写的吧inoremap HH <Home>" 单词中包含ll的太多了，所以用大写LLinoremap LL <End>" 快速跳转行首与行尾nnoremap L $nnoremap H ^" 向下5行noremap <C-j> 5j" 向上5行noremap <C-k> 5k"----vim 个人使用习惯配置end------

代码格式化

选中要格式化的代码<leader>f，默认leader是\键也就是\f完成代码格式化。

我把leader修改成空格了，所在我按空格+f就可以实现代码格式化，

" leader设置成空格let mapleader=" "

如果觉得选中代码在格式化比较麻烦，直接格式化当前编辑的源码。

:Format

重命名变量

<leader>rn用来重命名变量，真舒服。

代码段

提高效率神器，安装coc-snippets

项目主页：

/neoclide/coc-snippets

打开vim然后运行:CocInstall coc-snippets

安装完成后，重新使用vim编辑java代码的时候就可以使用代码段了，非常方便。以我们常用的

System.out.println为例，直接输入sout回车就搞定了。

使<tab>用于触发完成，完成确认，摘要扩展和跳转，就像VSCode一样。

inoremap <silent><expr> <TAB>\ pumvisible() ? coc#_select_confirm() :\ coc#expandableOrJumpable() ? "\<C-r>=coc#rpc#request('doKeymap', ['snippets-expand-jump',''])\<CR>" :\ <SID>check_back_space() ? "\<TAB>" :\ coc#refresh()function! s:check_back_space() abortlet col = col('.') - 1return !col || getline('.')[col - 1] =~# '\s'endfunctionlet g:coc_snippet_next = '<tab>'