Neovim安装Merginal插件后执行:Merginal切换缓冲区报错如何解决

问题背景 #

• Neovim环境安装Fugitive插件扩展Merginal后，执行:Merginal切换缓冲区时报错
• 本地Git配置正常，Fugitive其余功能均可正常使用

修复步骤 #

版本兼容性修复（最高频触发原因） #

• Merginal目前稳定版仅适配Fugitive v3.7及更早版本，Fugitive v4.x版本重构了底层API，会导致Merginal调用出错
• 若使用vim-plug管理插件，修改配置文件指定Fugitive版本：

  Plug 'tpope/vim-fugitive', { 'tag': 'v3.7' }
  Plug 'idanarye/vim-merginal'
  

• 保存配置后执行:PlugClean、:PlugInstall重装对应版本插件即可生效。

工作路径适配修复 #

• 若当前打开的缓冲区不属于Git工作区，或工作区路径包含空格、特殊字符，会触发Merginal路径解析错误
• 先切换到Git仓库根目录启动Neovim，打开仓库内的文件后再执行:Merginal命令即可。

依赖补全修复 #

• Merginal依赖pynvim组件运行，未安装对应依赖会触发运行时异常
• 终端执行pip3 install pynvim安装依赖后重启Neovim即可。

内容的提问来源于stack exchange，提问作者Riza Khan