如何让Hop.nvim在VSCode Neovim中正常工作？

问题现象 #

在VSCode Neovim中配置Hop.nvim后，package.loaded['hop']显示已加载，但触发<leader>w等绑定按键时，出现错误：

E492: Not an editor command: HopWord

需要实现类似Easymotion的跳转流程：按下空格键后标注可跳转位置。

相关配置文件 #

init.lua #

require("base") -- general settings
require("highlights") -- colourscheme and other highlights
require("keymaps") -- keymaps
require("plugins") -- plugins
require("hop") -- hop
require("bootstrap") -- packer auto-installer

print("✔ nvim loaded")
print(vim.inspect(package.loaded['hop']))

base.lua #

local g = vim.g
local o = vim.o
local opt = vim.opt

-- Map <leader> to space
g.mapleader = ' '
g.maplocalleader = ' '

keymaps.lua #

map("n", "<leader>w", ":HopWord<cr>")
map("n", "<leader>W", ":HopWordMW<cr>")
map("n", "f", ":HopChar1<cr>")
map("n", "F", ":HopChar1CurrentLine<cr>")

plugins.lua #

-- ...packer setup
local status, packer = pcall(require, "packer")
if not status then
  return
end

return packer.startup(function(use)

  use {
      'phaazon/hop.nvim',
      branch = 'v2', -- optional but strongly recommended
      -- config = [[require('hop')]],
      -- config = function()
      -- -- you can configure Hop the way you like here; see :h hop-config
      --   require'hop'.setup {}
      -- end
  }
  
  if packer_bootstrap then
    require("packer").sync()
  end
end)

hop.lua #

local setup, hop = pcall(require, "hop")

if not setup then
  return
end

hop.setup { keys = "etovxqpdygfblzhckisuran" }

加载输出 #

✔ nvim loaded
true
nil

解决方案 #

1. 调整配置加载顺序 #

当前keymaps在plugins之前加载，此时Hop插件尚未完成加载，导致Vim命令未注册。修改init.lua的加载顺序，确保插件先初始化：

require("bootstrap") -- packer auto-installer 放在最前面，保证packer可用
require("plugins") -- 加载插件
require("base") -- general settings
require("highlights") -- colourscheme and other highlights
require("hop") -- 初始化Hop配置
require("keymaps") -- 最后加载按键映射，确保依赖已就绪

print("✔ nvim loaded")
print(vim.inspect(package.loaded['hop']))

2. 改用Lua API绑定按键（推荐） #

直接调用Hop的Lua函数替代Vim Ex命令，避免依赖命令注册流程，同时更符合Neovim的Lua生态：
修改keymaps.lua：

-- 先定义通用map函数（如果之前没定义的话）
local map = function(mode, lhs, rhs, opts)
  opts = opts or { noremap = true, silent = true }
  vim.keymap.set(mode, lhs, rhs, opts)
end

-- 绑定Hop的Lua API
map("n", "<leader>w", function() require('hop').hint_words() end)
map("n", "<leader>W", function() require('hop').hint_words({ current_line_only = false }) end)
map("n", "f", function() require('hop').hint_char1() end)
map("n", "F", function() require('hop').hint_char1({ current_line_only = true }) end)

3. 确保Hop初始化生效 #

可以在plugins.lua中启用Hop的config回调，合并配置逻辑，避免单独的hop.lua可能出现的加载问题：
修改plugins.lua中的Hop配置块：

use {
    'phaazon/hop.nvim',
    branch = 'v2',
    config = function()
      require'hop'.setup { keys = "etovxqpdygfblzhckisuran" }
    end
}

此时可以删除单独的hop.lua文件，避免重复初始化。

4. 确认插件安装 #

运行:PackerSync确保Hop.nvim被正确下载安装，重启VSCode Neovim后测试功能。

完成以上步骤后，按下<leader>w即可触发单词跳转，标注可跳转位置，实现类似Easymotion的导航效果。

内容的提问来源于stack exchange，提问作者55 Cancri