Neovim中`gf`无法跳转至require引入的配置文件问题

问题根源 #

Neovim的require机制是从runtimepath下的lua目录加载模块，而gf命令默认依赖path变量搜索文件，且不会自动补全.lua后缀、也不识别require的模块路径规则，导致两者路径匹配逻辑不兼容：

• require("keymaps")对应lua/keymaps.lua，但gf默认只会搜索当前目录或path中的keymaps文件（不带后缀）
• 直接添加~/.config/nvim/lua/**到path无效，因为path需要的是目录列表而非递归通配符；:find lua/plugins能成功是因为指定了完整相对路径，但require("lua/plugins")会去查找lua/lua/plugins.lua，自然不存在。

解决方案 #

方案1：调整Vim内置变量适配require规则 #

通过修改path和suffixesadd，让gf自动匹配require的模块路径：

-- 将配置目录下的lua文件夹加入搜索路径
vim.opt.path:append(vim.fn.stdpath("config") .. "/lua")
-- 让gf自动补全.lua后缀
vim.opt.suffixesadd:append(".lua")

设置后，:find plugins会直接定位到lua/plugins.lua，光标在require("keymaps")的keymaps上按gf也能正常跳转。

方案2：自定义gf映射（针对Lua文件优化） #

如果不想全局修改path，可以给Lua文件单独设置gf映射，专门处理require的模块跳转：

vim.api.nvim_create_autocmd("FileType", {
  pattern = "lua",
  callback = function()
    vim.keymap.set("n", "gf", function()
      local target = vim.fn.expand("<cword>")
      local current_line = vim.fn.getline(".")
      -- 判断当前光标是否在require的引号内
      local is_require_module = current_line:match('require%("' .. target .. '"') or current_line:match("require%('" .. target .. "'")
      
      if is_require_module then
        local file_path = vim.fn.stdpath("config") .. "/lua/" .. target .. ".lua"
        if vim.fn.filereadable(file_path) == 1 then
          vim.cmd.edit(file_path)
          return
        end
      end
      -- 非require模块场景，使用默认gf行为
      vim.cmd.normal("gf")
    end, { buffer = true, silent = true })
  end,
})

这个映射只会在Lua文件中生效，遇到require里的模块名时直接跳转对应文件，其他场景保持默认gf功能。

内容的提问来源于stack exchange，提问作者Daniel Tan