vscode-nvim

vscode-nvim

基本介绍

我之前尝试在vscode中使用vsocde-vim插件来进行开发，但是我无法忍受它的卡顿，因此我将目光放在了vscode-nvim插件上：

它与vscode-vim插件还是有非常多的区别的，vscode-vim只是一个vim模拟器，好处是配置简单方便，不需要掌握过多的vimrc相关知识，缺点是运行慢，卡顿，没有原生vim操作的丝滑感，此外缺失许多原生vim的功能，如宏录制。

而vscode-nvim则是将neovim与vscode真正的连接起来，为你带来如丝般顺滑的编程体验，缺点是配置比较麻烦，需要在系统中安装neovim，并且所有的配置项会分为2部分，这在跨平台同步配置时不太方便。

不管你有没有使用过vscode-nvim插件，这篇文章都会给你带来一定的帮助，因为vscode-nvim插件的中文资料现在貌似不多，官方文档对于一些新手向的知识描述也不是很全，所以我才打算写了这一篇文章让更多的vscode用户走向vim的怀抱。

下载安装

nvim是vim的一个分支版本，它更强大也更优秀，因此对于现在很多已经将工作环境完全迁徙到终端下的程序员来说，nvim是一个更好的选择。

大多数Linux发行版中都内置安装了vi或者vim，但是neovim是肯定没有安装的，所以我们首先要安装neovim：

# 1.下载nvim安装包
$ wget https://github.com/neovim/neovim/releases/download/stable/nvim-macos.tar.gz

# 2.解压到指定的目录
$ tar xzf ./nvim-macos.tar.gz -C /usr/local/application/
$ mv /usr/local/application/nvim-osx64/ /usr/local/application/nvim

# 3.将nvim添加到系统环境变量，你可以创建软链接或者直接编辑/etc/profile文件
PATH=/usr/local/application/nvim/bin:$PATH

nvim安装完成之后，打开vscode插件商店，搜索neovim插件并安装：

基础配置

安装完成之后我们需要对vscode进行一些基础设置。

1. 仅MAC用户，关闭MAC的重复键
$ defaults write com.microsoft.VSCode ApplePressAndHoldEnabled -bool false 

2. 为代码编辑区域设置相对行号以方便vim模式操作，在settings.json中添加上以下配置项
"editor.lineNumbers": "relative",

3. 关闭自动传参建议，使用按键手动触发，在settings.json中添加上以下配置项
"editor.parameterHints.enabled": false,

4. 控制资源管理器中的键盘导航无法自动触发，在settings.json中添加上以下配置项
"workbench.list.automaticKeyboardNavigation": false,

5. 控制编辑器是否可以将光标移动到最后一行以后或者最上一行以上，这对vim模式下的gg、G命令来说更加友好，在settings.json中添加上以下配置项
"editor.scrollBeyondLastLine": false,

初始工作做完以后，接下来就需要将nvim与vscode-nvim插件链接起来，使之互相之间产生关系，你需要根据自己所使用的平台在settings.json中加入下面这个配置项，添加完成后需要重启vscode实例：

// Windows
"vscode-neovim.neovimExecutablePaths.win32": "D:\\Application\\Neovim\\bin\\nvim.exe",

// Linux
"vscode-neovim.neovimExecutablePaths.linux": "/usr/local/application/nvim/bin/nvim",

// Mac
"vscode-neovim.neovimExecutablePaths.darwin": "/usr/local/application/nvim/bin/nvim",

设计哲学

以下是关于vscode-nvim如何工作的，摘自官方文档：

• VScode连接到neovim实例
• 打开某个文件时，会在nvim中创建一个暂存缓冲区，并使用来自 vscode的文本内容进行初始化
• NORMAL / VISUAL模式命令直接发送到neovim。该扩展程序侦听缓冲区事件并应用来自neovim的编辑
• 当进入插入模式时，扩展停止监听击键事件并将打字模式委托给 vscode（这里没有执行 Neovim 通信）
• 从插入模式按下退出键后，扩展程序将从插入模式获得的更改发送到 Neovim

差异对比

以下是vscode-nvim与原生nvim的使用差异对比，摘自官方文档：

• 例如命令模式下的:e、:w、:q、:sp系列、:tab系列等命令实际上都不是调用的nvim指令完成的，而是调用的vscode指令，不要像在nvim中一样使用它们，比如ctrl+r命令在nvim下是redo命令，而在vscode下则不会有任何效果，你可以在后面通过更改热键来改变它们
• 可视模式不会产生vscode选择，因此任何需要选择的vscode命令都不起作用。但是可以通过默认热键(f1/ctrl/cmd+shift+p)从可视模式调用vscode命令选择器将vim选择转换为真正的vscode选择。对于某些命令（例如注释和格式设置），此转换也会自动完成。如果您使用一些自定义映射来调用依赖于真实vscode选择的vscode命令，您可以使用VSCodeNotifyRange/VSCodeNotifyRangePo（第一个逐行，后一个字符），它将在调用命令之前会将vim视觉模式选择转换为vscode选择
• 当您键入某些命令时，它们可能会替换另一个命令，例如:write将替换为:Write.这是正常的。
• 滚动是由VSCode完成的。而 <C-d> / <C-u> / etc略有不同
• 编辑器自定义（相对行号、滚动条等）由VSCode处理
• 点重复(.)略有不同-在更改范围内移动光标不会破坏重复序列。在Neovim中，如果您abc<cursor>在插入模式下输入，则将光标移至a<cursor>bc并1在此处输入重复序列将是1.但是在vscode中它会是a1bc.另一个区别是，当您在插入模式下删除某些文本时，点重复仅从右到左起作用，这意味着在运行点重复时它会将Del键视为BS键

定义热键

启动模式

不乏有一些之前使用过nvim的用户对nvim本身设置了很多选项。

但其实这些选项可能会对vsocde-nvim的性能产生影响，为了屏蔽这些影响，vscode-nvim官方也贴心的编写了vimscript来区分你的nvim启动模式。

我们只需要将这段vimscript放置在~/.config/nvim/init.vim文件中即可。

• Ps：~/.config/nvim/init.vim文件是nvim的配置文件，如果不存在，那么请创建它

如下所示：

" 选择启动模式、作为vscode扩展启动、或者作为本体启动
" 时所加载的配置项
if exists('g:vscode')
     " VSCode extension
else
     " ordinary neovim
endif

举一个简单的例子，我下面有3个nvim选项：

• set mouse=a：让nvim支持鼠标操作，我希望在nvim正常启动时加载
• set nobackup：不创建备份文件，我希望在nvim作为vscode-nvim插件依赖进行启动时加载
• let mapleader = "\<space>"：设置前导键，我希望无论nvim在那种情况下启动都进行加载

这个时候就可以对~/.config/nvim/init.vim文件进行这样的编辑：

if exists('g:vscode')
    " 以vsocde-nvim插件作为依赖启动时加载的配置项
    set nobackup
else
    " 以正常模式启动nvim时加载的配置项
    set mouse=a
endif

" 始终都会加载的配置项
let mapleader = "\<space>"

另外对于一些插件来说，你也可以单独的指定它们的启动模式，如禁用原生的vim-easymotion，而启用vscode-nvim作者改版的vim-easymotion，这个内容在下面会介绍到：

" inside plug#begin:
" use normal easymotion when in vim mode
Plug 'easymotion/vim-easymotion', Cond(!exists('g:vscode'))

" use vscode easymotion when in vscode mode
Plug 'asvetliakov/vim-easymotion', Cond(exists('g:vscode'), { 'as': 'vsc-easymotion' })

调用vscode命令

nvim除开可以定义自己本身的热键外，还可以通过一些函数间接的调用vscode下的命令，这里只例举一些异步调用的函数：

- 使用可选参数调用vscode命令
VSCodeNotify(command, ...)

- 将line1到line2的可视模式选择变更为vscode的选择，并且会调用vscode命令，如果将leaveSelection设置成1，会在调用命令后删除vscode选择
VSCodeNotifyRange(command, line1, line2, leaveSelection ,...)

- 将line1.pos1到line2.pos2的可视模式选择变更为vscode的选择，并且会调用vscode命令，如果将leaveSelection设置成1，会在调用命令后删除vscode选择
VSCodeNotifyRangePos(command, line1, line2, pos1, pos2, leaveSelection ,...)

- 将可视模式下的选择变更为vscode的选择，并且会调用vscode命令，如果将leaveSelection设置成1，会在调用命令后删除vscode选择
VSCodeNotifyVisual(command, leaveSelection, ...)

个人热键方案

使用vim或者nvim插件时，如何配置热键是一个十分棘手的问题，下面是我自用的一些热键定义方案。

我目前使用的是mac平台，所以cmd按键会比ctrl按键更加常用，如果是windows或者linux平台，则将cmd替换为ctrl按键即可。

cmd + g c ： 显示命令面板
cmd + g s ： 打开设置页面
cmd + g k ： 打开热键映射
cmd + g d ： 打开一个目录
cmd + g f ： 打开一个文件
cmd + g h ： 打开最近记录
cmd + g n ： 新建vscode实例
cmd + g q ： 关闭vscode示例

cmd + f n ： 新建文件
cmd + f o ： 打开文件
cmd + f e ： 另存为文件
cmd + f s ： 保存文件
cmd + f w ： 保存所有文件
cmd + f q ： 关闭文件
cmd + f a ： 关闭所有文件

cmd + n [ ： 切换侧边栏显示状态
cmd + n 1 ： 显示文件资源管理器
cmd + n 2 ： 显示TODO Tree
cmd + n 3 ： 显示全局搜索
cmd + n 4 ： 显示debug
cmd + n 5 ： 显示版本控制
cmd + n 6 ： 显示SQL Tools
cmd + n 7 ： 显示Docker
cmd + n 8 ： 显示测试
cmd + n 9 ： 显示插件商店

cmd + p ] ： 切换面板显示状态
cmd + p 1 ： 显示问题
cmd + p 2 ： 显示输出
cmd + p 3 ： 显示终端
cmd + p 4 ： 显示调试控制台
cmd + p 5 ： 显示SQL CONSOLE

cmd + q ：关闭当前选项卡或分屏
cmd + e ：聚焦在第一个选项卡中
cmd + , ：切换到上一个选项卡
cmd + . ：切换到下一个选项卡

cmd + h ： 触发帮助提示
cmd + j ： 触发参数提示
cmd + k ： 触发建议提示
cmd + m ： 触发快速修复
cmd + n ： 移动到下一个建议
cmd + p ： 移动到上一个建议
tab     ： 选择下一个建议
enter   ： 选择当前建议

cmd + = ： 放大字体
cmd + - ： 缩小字体
cmd + alt + l ：格式化代码（个人习惯）

zR ： 展开所有折叠
zM ： 关闭所有折叠
zo ： 展开当下折叠
zc ： 关闭当下折叠
zz ： 切换当下折叠

jj ： 退出INSERT模式
zz ： 切换代码折叠（原生vim的zz不是切换折叠）
gc ： 进行行注释
gC ： 进行块注释


H ：跳转行首、取代^
L ：跳转行尾、取代$

g[ ： 跳转到上一个问题
g] ： 跳转到下一个问题

我的keybindings

以下是我的keybindings.json文件：

[
    // 按jj退出INSERT模式
    {
        "command": "vscode-neovim.compositeEscape1",
        "key": "j",
        "when": "neovim.mode == insert && editorTextFocus",
        "args": "j"
    },
    // 显示命令面板
    {
        "key": "cmd+g c",
        "command": "workbench.action.showCommands"
    },
    // 打开设置页面
    {
        "key": "cmd+g s",
        "command": "workbench.action.openSettings"
    },
    // 打开热键映射
    {
        "key": "cmd+g k",
        "command": "workbench.action.openGlobalKeybindings"
    },
    // 打开一个目录
    {
        "key": "cmd+g d",
        "command": "workbench.action.files.openFolder"
    },
    // 打开一个文件
    {
        "key": "cmd+g f",
        "command": "workbench.action.files.openFile"
    },
    // 打开最近记录
    {
        "key": "cmd+g h",
        "command": "workbench.action.openRecent"
    },
    // 新建vscode实例
    {
        "key": "cmd+g n",
        "command": "workbench.action.newWindow"
    },
    // 关闭vscode实例
    {
        "key": "cmd+g q",
        "command": "workbench.action.closeWindow"
    },
    // 新建文件
    {
        "key": "cmd+f n",
        "command": "welcome.showNewFileEntries",
    },
    // 打开文件
    {
        "key": "cmd+f o",
        "command": "workbench.action.files.openFileFolder"
    },
    // 另存为文件
    {
        "key": "cmd+f e",
        "command": "workbench.action.files.saveAs"
    },
    // 保存文件
    {
        "key": "cmd+f s",
        "command": "workbench.action.files.save"
    },
    // 保存所有文件
    {
        "key": "cmd+f w",
        "command": "workbench.action.files.saveAll"
    },
    // 关闭文件
    {
        "key": "cmd+f q",
        "command": "workbench.action.closeActiveEditor"
    },
    // 关闭所有文件
    {
        "key": "cmd+f a",
        "command": "workbench.action.closeAllEditors"
    },
    // 切换侧边栏显示状态
    {
        "key": "cmd+n [",
        "command": "workbench.action.toggleSidebarVisibility"
    },
    // 显示文件资源管理器
    {
        "key": "cmd+n 1",
        "command": "workbench.files.action.focusFilesExplorer"
    },
    // 显示TODO Tree
    {
        "key": "cmd+n 2",
        "command": "todo-tree-view.focus"
    },
    // 显示全局搜索
    {
        "key": "cmd+n 3",
        "command": "workbench.action.replaceInFiles",
    },
    // 显示debug
    {
        "key": "cmd+n 4",
        "command": "workbench.view.debug",
        "when": "viewContainer.workbench.view.debug.enabled"
    },
    // 显示版本控制
    {
        "key": "cmd+n 5",
        "command": "workbench.view.scm",
        "when": "workbench.scm.active"
    },
    // 显示SQL Tools
    {
        "key": "cmd+n 6",
        "command": "workbench.view.extension.sqltoolsActivityBarContainer"
    },
    // 显示Docker
    {
        "key": "cmd+n 7",
        "command": "workbench.view.extension.dockerView"
    },
    // 显示测试
    {
        "key": "cmd+n 8",
        "command": "workbench.view.testing.focus"
    },
    // 显示插件商店
    {
        "key": "cmd+n 9",
        "command": "workbench.view.extensions",
        "when": "viewContainer.workbench.view.extensions.enabled"
    },
    // 切换面板显示状态
    {
        "key": "cmd+p [",
        "command": "workbench.action.togglePanel"
    },
    // 显示问题
    {
        "key": "cmd+p 1",
        "command": "workbench.panel.markers.view.focus"
    },
    // 显示输出
    {
        "key": "cmd+p 2",
        "command": "workbench.action.output.toggleOutput",
        "when": "workbench.panel.output.active"
    },
    // 显示终端
    {
        "key": "cmd+p 3",
        "command": "workbench.action.terminal.toggleTerminal",
        "when": "terminal.active"
    },
    // 显示调试控制台
    {
        "key": "cmd+p 4",
        "command": "workbench.debug.action.toggleRepl",
        "when": "workbench.panel.repl.view.active"
    },
    // 显示SQL CONSOLE
    {
        "key": "cmd+p 5",
        "command": "workbench.view.extension.sqltoolsPanelContainer"
    },
    {
        "key": "cmd+q",
        "command": "workbench.action.closeActiveEditor"
    },
    // 聚集在第一个选项卡中
    {
        "key": "cmd+e",
        "command": "workbench.action.focusFirstEditorGroup"
    },
    // 切换到上一个选项卡
    {
        "key": "cmd+,",
        "command": "workbench.action.previousEditor"
    },
    // 切换到下一个选项卡
    {
        "key": "cmd+.",
        "command": "workbench.action.nextEditor"
    },
    // 触发帮助提示
    {
        "key": "cmd+h",
        "command": "editor.action.showHover",
        "when": "editorTextFocus"
    },
    // 触发参数提示
    {
        "key": "cmd+j",
        "command": "editor.action.triggerParameterHints",
        "when": "editorHasSignatureHelpProvider && editorTextFocus"
    },
    {
        "key": "cmd+j",
        "command": "closeParameterHints",
        "when": "editorFocus && parameterHintsVisible"
    },
    // 触发建议提示
    {
        "key": "cmd+k",
        "command": "editor.action.triggerSuggest",
        "when": "editorHasCompletionItemProvider && textInputFocus && !editorReadonly"
    },
    {
        "key": "cmd+k",
        "command": "hideSuggestWidget",
        "when": "suggestWidgetVisible && textInputFocus"
    },
    // 触发快速修复
    {
        "key": "cmd+m",
        "command": "editor.action.quickFix",
        "when": "editorHasCodeActionsProvider && editorTextFocus && !editorReadonly"
    },
    {
        "key": "cmd+.",
        "command": "-editor.action.quickFix",
        "when": "editorHasCodeActionsProvider && editorTextFocus && !editorReadonly"
    },
    // 移动到下一个建议
    {
        "key": "cmd+n",
        "command": "selectNextSuggestion",
        "when": "suggestWidgetMultipleSuggestions && suggestWidgetVisible && textInputFocus"
    },
    // 移动到上一个建议
    {
        "key": "cmd+p",
        "command": "selectPrevSuggestion",
        "when": "suggestWidgetMultipleSuggestions && suggestWidgetVisible && textInputFocus"
    },
    // 放大字体
    {
        "key": "cmd+=",
        "command": "editor.action.fontZoomIn"
    },
    // 缩小字体
    {
        "key": "cmd+-",
        "command": "editor.action.fontZoomOut"
    },
    // 格式化代码
    {
        "key": "cmd+alt+l",
        "command": "editor.action.formatDocument",
        "when": "editorHasDocumentFormattingProvider && editorTextFocus && !editorReadonly && !inCompositeEditor"
    },
    // 选择全部, 在文本焦距点中失效
    {
        "key": "cmd+a",
        "command": "editor.action.selectAll",
        "when": "!editorTextFocus"
    },
    {
        "key": "cmd+a",
        "command": "-editor.action.selectAll"
    },
]

我的init.vim

下面是我的~/.config/nvim/init.vim文件，基本属于非常轻量级的配置了：

" 当打开nvim时，若没有下载vim-plug则自动下载
if empty(glob('~/.config/nvim/autoload/plug.vim'))
    silent !curl -fLo ~/.config/nvim/autoload/plug.vim --create-dirs https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
    autocmd VimEnter * PlugInstall --sync | source $MYVIMRC
endif


" 始终都会加载的配置项
let mapleader = "\<space>"
" 使用系统剪切板
set clipboard=unnamed

" 自动切换输入法
if executable('im-select')
    autocmd InsertLeave * :call system("im-select com.apple.keylayout.ABC")
    autocmd CmdlineLeave * :call system("im-select com.apple.keylayout.ABC") 
endif

" ----- settings ----
if exists('g:vscode')
    " ----- Plug -----
    call plug#begin('~/.config/nvim/autoload/')
        " 快速跳转
        Plug 'asvetliakov/vim-easymotion'
        " 包裹修改
        Plug 'tpope/vim-surround'
    call plug#end()
	" 切换行注释	
	nnoremap gc <Cmd>call VSCodeNotify('editor.action.commentLine')<CR>
	" 切换块注释
	nnoremap gC <Cmd>call VSCodeNotify('editor.action.blockComment')<CR>
	" 展开所有折叠
	nnoremap zR <Cmd>call VSCodeNotify('editor.unfoldAll')<CR>
	" 关闭所有折叠
	nnoremap zM <Cmd>call VSCodeNotify('editor.foldAll')<CR>
	" 展开当下折叠
	nnoremap zo <Cmd>call VSCodeNotify('editor.unfold')<CR>
	" 关闭当下折叠
	nnoremap zc <Cmd>call VSCodeNotify('editor.fold')<CR>
	" 切换当下折叠
	nnoremap zz <Cmd>call VSCodeNotify('editor.toggleFold')<CR>
	" 转到文件中上一个问题
	nnoremap g[ <Cmd>call VSCodeNotify('editor.action.marker.prevInFiles')<CR>
	" 转到文件中下一个问题
	nnoremap g] <Cmd>call VSCodeNotify('editor.action.marker.nextInFiles')<CR>
    " 用H替换掉^
    noremap H ^
    " 用L替换掉$
    noremap L $
    " 使用vscode的undo替换nvim的undo
	nnoremap u <Cmd>call VSCodeNotify('undo')<CR>
    " easymotion相关配置
    let g:EasyMotion_smartcase = 0
    " easymotion前缀 leader leader
    map <Leader> <Plug>(easymotion-prefix)
    " 其他键位绑定
    map <Leader>l <Plug>(easymotion-lineforward)
    map <Leader>j <Plug>(easymotion-j)
    map <Leader>k <Plug>(easymotion-k)
    map <Leader>h <Plug>(easymotion-linebackward)

else
    " 以正常模式启动nvim时加载的配置项
    " 显示行号
	set number
	" 设置相对行号
	set relativenumber
	" 设置行宽
	set textwidth=80
	" 设置自动换行
	set wrap
	" 是否显示状态栏
	set laststatus=2
	" 语法高亮
	syntax on
	" 支持鼠标
	set mouse=a
	" 设置编码格式
	set encoding=utf-8
	" 启用256色
	set t_Co=256
	" 开启文件类型检查
	filetype indent on
	" 设置自动缩进
	set autoindent
	" 设置tab缩进数量
	set tabstop=4
	" 设置>>与<<的缩进数量
	set shiftwidth=4
	" 将缩进转换为空格
	set expandtab
	" 自动高亮匹配符号
	set showmatch
	" 自动高亮匹配搜索结果
	set nohlsearch
	" 开启逐行搜索，也就是说按下一次按键就继续一次搜索
	set incsearch
	" 开启类型检查
	" set spell spelllang
	" 开启命令补全
	set wildmenu
	" 不创建备份文件
	set nobackup
	" 不创建交换文件
	set noswapfile
	" 多窗口下光标移动到其他窗口时自动切换工作目录
	set autochdir
    " ----- Plug -----
    call plug#begin('~/.config/nvim/autoload/')
        " 快速跳转
        Plug 'easymotion/vim-easymotion'
        " 包裹修改
        Plug 'tpope/vim-surround'
        " vim中文文档
        Plug 'yianwillis/vimcdoc'
        " 颜色插件
        Plug 'theniceboy/vim-deus'
        " 根据内容自动获取文件类型
        Plug 'Shougo/context_filetype.vim'
        " 自动进行注释
        Plug 'tyru/caw.vim'
        " 包裹修改
        Plug 'tpope/vim-surround'
        " 多光标模式操作
        Plug 'mg979/vim-visual-multi', {'branch': 'master'}
    call plug#end()
    " -- ctrl+/设置为打开、关闭注释
    if has('win32')
        nmap <C-/> gcc
        vmap <C-/> gcc
    else
        nmap <C-_> gcc
        vmap <C-_> gcc
    endif
    "按键映射前缀: <leader>v。
    let g:VM_maps = {}                 "取消默认按键映射。
    let g:VM_maps['Find Under'] = 'gb' "进入多光标模式并选中光标下字符串。
endif

vim-plug

基本介绍

vim-plug是一款vim插件，我们可以使用它来管理、使用、下载其他的vim插件，总而言之vim中可以用插件来管理插件。

上面的配置文件中已经设置了当打开nvim时自动安装vim-plug：

" 当打开nvim时，若没有下载vim-plug则自动下载
if empty(glob('~/.config/nvim/autoload/plug.vim'))
    silent !curl -fLo ~/.config/nvim/autoload/plug.vim --create-dirs https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
    autocmd VimEnter * PlugInstall --sync | source $MYVIMRC
endif

该插件使用非常简单，记住以下几个命令即可：

:PlugStatus
:PlugInstall
:PlugClean
:PlugUpdate

我们可在github或者vimAwesome中搜索你需要的插件，并将它们安装在nvim中，安装方式如下所示，只需要在init.vim配置文件中加入以下选项即可：

" ----- Plug -----
call plug#begin('~/.config/nvim/autoload/')
    " 快速跳转
    Plug 'asvetliakov/vim-easymotion'
    " 包裹修改
    Plug 'tpope/vim-surround'
call plug#end()

然后你需要x!后重新进入nvim，并在COMMAND模式下输入:PlugInstall，它将自动安装所有插件。

如果想卸载某个插件，则直接将其进行注释即可，这样nvim在启动时就不会加载该插件了，如果想删除某个插件，则输入:PlugClean命令，它将删除所有被注释后的插件。

vim-easymotion

原生的vim-easymotion插件在vscode-nvim中会出现一些问题，因此vscode-nvim作者fork了一份vim-easymotion，我们可直接对其进行安装。

在上面我的init.vim文件中都已经做好了一些基本配置，如下所示：

" 安装
call plug#begin('~/.config/nvim/autoload/')
    " 快速跳转
    Plug 'asvetliakov/vim-easymotion'
    " 包裹修改
    Plug 'tpope/vim-surround'
call plug#end()

" 键位绑定
" easymotion相关配置
let g:EasyMotion_smartcase = 0
" easymotion前缀 leader leader
map <Leader> <Plug>(easymotion-prefix)
" Gif config
map <Leader>l <Plug>(easymotion-lineforward)
map <Leader>j <Plug>(easymotion-j)
map <Leader>k <Plug>(easymotion-k)
map <Leader>h <Plug>(easymotion-linebackward)

原生的easymotion插件的使用是leader leader作为前缀，而该fork的easymotion插件则推荐只使用一个leader，下面是它的使用方法：

<leader>w       ： 高亮所有词的词首字母
<leader>s<char> ： 全页搜索该字符
<leader>f<char> ： 光标以下搜索该字符
<leader>h<char> ： 光标以左搜索该字符
<leader>l<char> ： 光标以右搜索该字符
<leader>j<char> ： 光标以下搜索该字符
<leader>k<char> ： 光标以上搜索该字符

vim-surround

vim-surround插件是非常方便的一款插件，可以快速的修改包裹符号，我也对他进行了安装：

" 安装
call plug#begin('~/.config/nvim/autoload/')
    " 快速跳转
    Plug 'asvetliakov/vim-easymotion'
    " 包裹修改
    Plug 'tpope/vim-surround'
call plug#end()

使用也非常简单，如下所示：

ds<existing> 		  ： 将某个包裹修改为另一个包裹
cs<existing><desired> ： 删除某个包裹

示例如下：

# 删除以下的[]
[1, 2, 3] -> ds[

# 将以下的[]修改为()
[1, 2, 3] -> cs[(

其他问题

自动切换输入法

如果你在INSERT模式下使用中文输入法进行编辑，当ESC到NORMAL模式下后，它将依然保持中文输入法，这会使我们需要频繁的使用ctrl+shift或者cmd+space进行输入法切换，非常麻烦。

为了解决这个问题，你必须先在你的计算机上安装一个im-select脚本：

$ curl -Ls https://raw.githubusercontent.com/daipeihust/im-select/master/install_mac.sh | sh

这个脚本有2个作用，当你输入im-select后它将获取当前输入法，当你输入im-select xxx后它将切换至xxx输入法。

首先你需要先切换到英文输入法中到终端执行im-select命令，并把结果保存下来：

$ im-select
com.apple.keylayout.ABC

然后再到init.vim中输入以下代码即可，我上面也已经进行了解决：

" 自动切换输入法
if executable('im-select')
    autocmd InsertLeave * :call system("im-select com.apple.keylayout.ABC")
    autocmd CmdlineLeave * :call system("im-select com.apple.keylayout.ABC") 
endif

可视模式的选择

vscode-nvim插件中的VISUAL模式并非真正的vscode选择，这是我对比vscode-vim插件来说对vscode-nvim插件所最不能接受的一个点，因为我会使用很多翻译插件来进行源代码注释翻译，如google-translate插件或者comment-translate。

尽管vscode-nvim提供了以下热键来将VISUAL模式下的选择变更为vscode选择，但是仍然会出现一些问题，它仍然不是选择全部的VISUAL行：

f1
ctrl+shift+p
cmd+shift+p

后续希望作者能够将这点进行改进吧，也呼吁大家去提一些issues。

查看所有的错误

当使用vscode-nvim或者vscode-vim插件时，Error Lens这款vscode插件总能给你带来意外的惊喜，让你更加直观的看到当前页中所有代码的问题、警告、错误信息。

如下图所示：

它可能会影响vscode-nvim的性能，但我仍然十分依赖它。

插件与性能损失

如果您有任何性能问题（通常是光标抖动），请确保您没有使用这些类型的扩展：

1）任何经常渲染装饰器的东西：

• 行号扩展（VSCode 内置了对普通/相对行号的支持）
• 缩进指南扩展（VSCode 有内置的缩进指南）
• 括号荧光笔扩展（VSCode 有内置功能）

2）延迟扩展主机的 VSCode 扩展，如“Bracket Pair Colorizer”

3）增加延迟并导致性能问题的 VIM 插件。

• 确保禁用不需要的插件，因为其中许多插件对 vscode 没有意义并且可能会导致问题。
• 您不需要任何代码、突出显示、完成、lsp 插件以及任何生成窗口/缓冲区（nerdtree 和类似的）、模糊查找器等的插件。
• 许多导航/文本对象/编辑插件应该没问题。

如果不确定，请禁用所有其他扩展且重新加载 vscode window，并在报告之前查看问题是否仍然存在。

内置定义的热键

下面这些命令都是由vscode-nvim插件调用vscode中的命令完成的，仅限于COMMAND模式下使用，这些命令在原生的nvim中也都适用，不同的是它们并不是调用的原生命令接口。

1）文件管理命令：

命令	描述
:ene	创建新的无标题文件
:e	快速打开文件
:find	按名称搜索文件
:sav	另存为文件
:w	保存当前文件
:q	关闭所有编辑器
:wq	保存当前文件，并关闭活动编辑器
:x	保存当前文件，并关闭活动编辑器
:qa	保存所有文件，并关闭所有编辑器
:wa	保存所有文件，不关闭任何编辑器
:wqa	保存所有文件，并关闭所有编辑器
:xa	保存所有文件，并关闭所有编辑器

2）标签相关命令：

命令	描述
:tabnew	创建新的无标题文件
:tabe	快速打开文件
:tabf	按名称搜索文件
:tabc	关闭当前的的编辑器
:tabo	关闭其他所有编辑器
:tabp	切换到上一个编辑器
:tabn	切换到下一个编辑器
:tabfirst	切换到第一个编辑器
:tablast	切换到末一个编辑器

3）窗口相关命令：

命令	描述
:sp	水平拆分编辑器
:vsp	垂直拆分编辑器
:new	水平拆分编辑器，并创建新的无标题文件
:vnew	垂直拆分编辑器，并创建新的无标题文件
:only	关闭所有的编辑器

下面这些热键都是由vscode-nvim插件调用vscode中的命令完成的，原生nvim中不存在下面大多数热键。

1）代码编辑区热键：

热键（1）	热键（2）	功能描述
=	==	格式化选定内容
gh	K	显示悬停
gd	C-]	转到定义
gf	无	转到声明
gH	无	查看引用
gO	无	转到符号
C-W gd	C-W gf	打开侧边的定义
gD	无	速览定义
gF	无	查看声明
tab	无	切换小部件焦点
C-p		切换上一个建议
C-n		切换下一个建议

2）一些INSERT模式下定义的热键：

热键	描述
C-r [0-9a-z"%#*+:.-=]	从寄存器粘贴内容
C-a	插入之前插入的内容
C-o	切换到NORMAL模式中执行一个命令，然后返回
C-u	删除当前光标当行首前的所有内容
C-w	删除左侧的单词
C-h	删除左侧的字符
C-t	光标向右移动，单位是一个缩进
C-d	光标向左移动，单位是一个缩进
C-j	插入新行
C-c	退出INSTER模式

3）一些侧边栏中进行移动的热键：

热键	描述
j / k	向下向上移动光标
h / l	打开或关闭项目
Enter	打开项目
gg	返回顶部
G	返回底部
o	切换展开
C-u / C-d	向上或向下翻页
Escape	切换键盘导航

4）文件资源管理的热键：

热键	描述
r	重命名文件
d	删除文件
y	拷贝文件
x	剪切文件
p	粘贴文件
v	以垂直拆分的方式打开文件
a	创建新文件
S-a	创建新目录

此外还有一些热键这里没有例举出来，可参阅官方文档进行查看。