前言
vim之美妙我就不过多介绍了,懂的自然懂。之前我已经有一篇文章介绍如何使用SpaceVim来搭建Java开发环境。
传送门:《从零开始vim搭建Java开发环境[视频]》
最近使用coc.nvim,感觉体验也很棒,与是就想使用coc.nvim平台也来搭建个Java开发环境,来比较一下哪个更适合自己。
环境
搭建环境千差万别,大同小异,理论上各大平台都是支持的,我把我的环境发一下仅供参考。
项目 | 版本 |
---|---|
操作系统 | Linux version 5.11.11-arch1-1 (linux@archlinux) |
vim | 8.2 +python/dyn +python3/dyn |
环境搭建
我们的主题就是用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》
https://blog.csdn.net/lxyoucan/article/details/114309132 - 《CentOS 安装vim8 + python3》
https://blog.csdn.net/lxyoucan/article/details/114274117 - 《archlinux 安装neovim并增加python3支持》
https://blog.csdn.net/lxyoucan/article/details/115280569 - 《macOS中SpaceVim搭建java开发环境》
https://blog.csdn.net/lxyoucan/article/details/113873596
安装vim-plug
软件管理器还是需要一个的,我们就使用coc.nvim演示中使用的vim-plug来管理插件吧。
项目主页:
https://github.com/junegunn/vim-plug
Unix中vim环境执行下面命令完成安装,其他环境请参考项目主页的介绍。
curl -fLo ~/.vim/autoload/plug.vim --create-dirs \
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
成功执行,就已经安装完成了。后面我们安装vim插件需要vim-plug。
安装node.js
coc.nvim依赖node.js而且版本要求nodejs >= 10.12。
archlinux下执行:
sudo pacman -S nodejs
sudo pacman -S npm
其他系统环境请参考:https://nodejs.org/
查node.js版本
node -v
v15.13.0
安装coc.nvim
终于轮到今天的主角了。看了一下贡献者中前几个是国内的大佬,在此膜拜一下。
项目地址:
https://github.com/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 nobackup
set 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=number
else
set signcolumn=yes
endif
" 使用制表符可完成带有前面字符的触发操作并进行导航。
" 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() abort
let col = col('.') - 1
return !col || getline('.')[col - 1] =~# '\s'
endfunction
" 使用 <c-space> 触发自动完成。
if has('nvim')
inoremap <silent><expr> <c-space> coc#refresh()
else
inoremap <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')
else
execute '!' . &keywordprg . " " . expand('<cword>')
endif
endfunction
" 按住光标时突出显示该符号及其参考。
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 mygroup
autocmd!
" 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 paragraph
xmap <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 :call CocAction('fold', <f-args>)
" Add `:OR` command for organize imports of the current buffer.
command! -nargs=0 OR :call CocAction('runCommand', 'editor.action.organizeImport')
" 添加(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
项目主页:
https://github.com/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
2021年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
解决办法参考:https://github.com/neoclide/coc-java/issues/99
JDT Lang Sever的57版可以正常使用
https://download.eclipse.org/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呢?
项目主页:
https://github.com/vim-airline/vim-airline
插件管理中增加:
Plug 'vim-airline/vim-airline'
Plug 'vim-airline/vim-airline-themes'
:wq
保存退出,重启打开vim后,执行:PlugInstall
完成插件的安装。
并增加配置
" vim-airline
let g:airline#extensions#tabline#enabled = 1
let g:airline_powerline_fonts = 1
看一下美化后的效果:
多了一些字体图标,看起来更时髦。不知道的还以为不是命令行程序呢。
解决乱码
如果你发现你显示的不是像我截图里的那样的,而是有乱码?之类的。那是因为字体的原因。
只要安装nerd-font字体,并设置终端模拟器的字体为nerd-font
。
以macOS为例。
使用Homebrew安装nerd-font字体,顺序运行如下命令行:
brew tap homebrew/cask-fonts
brew 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=1
let &t_SI.="\e[5 q" "SI = INSERT mode
let &t_SR.="\e[4 q" "SR = REPLACE mode
let &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的太多了,所以用大写LL
inoremap 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
项目主页:
https://github.com/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() abort
let col = col('.') - 1
return !col || getline('.')[col - 1] =~# '\s'
endfunction
let g:coc_snippet_next = '<tab>'
安装honza/vim-snippets
Plug 'honza/vim-snippets'
安装完成以后会更多实用的代码段。
比如:
clc
public class Person {
public Person() {
Person
}
}
这里有个美中不足的,第二行末尾会多出个Person不知为什么。
sout :
System.out.println();
psvm
public static void main (String[] args) {
}
基本上我在Intelj IDEA中常用代码段都有了。
其他
:CocCommand
查询支持的命令
coc-lists
安装方法:
:CocInstall coc-lists
coc-actions
:CocInstall coc-actions
生成getter setter
执行:CocAction
操作如下:
打开一个终端
:term
总结
与SpaceVim实现的方式各有优化缺点。比较起来感觉SpaceVim相对更重一些,集成了很多好用的插件对于新手更友好一些。coc.nvim感觉就比较轻量,coc.nvim共用了一些vscode的插件,个人感觉生态会更好一些。
如果觉得有用的话,点赞评论支持一下吧!